@shoper/cli 0.1.0-9 → 0.2.1-0

package/build/theme/commands/delete/theme_delete_command.js

@@ -0,0 +1,97 @@
+import { Args } from '@oclif/core';
+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 { renderOnce } from '../../../ui/ui_utils.js';
+import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_credentials_error.js';
+import React from 'react';
+import { THEME_DELETE_API_NAME } from '../../features/theme/delete/theme_delete_constants.js';
+import { UnpermittedCommandError } from '../ui/unpermitted_command_error.js';
+import { Text } from '../../../ui/text.js';
+import { Info } from '../../../ui/message_box/info.js';
+import { MissingThemeIdError } from '../ui/missing_theme_id_error.js';
+import { Box } from '../../../ui/box.js';
+import { ThemeDeletedSuccessfully } from './ui/theme_deleted_successfully.js';
+import { ThemeDeletionWarning } from './ui/theme_deletion_warning.js';
+import { promptConfirmation } from '../../../ui/prompts/prompt_confirmation.js';
+import { ThemeError } from '../ui/theme_error.js';
+export class ThemeDeleteCommand extends BaseThemeCommand {
+    static summary = 'Permanently deletes the specified theme from your store.';
+    static description = 'This action cannot be undone, so make sure you really want to remove this theme.\n\nYou can run this command from a specific theme directory (ID not needed) or outside any theme directory (theme ID required).';
+    static examples = [
+        {
+            description: 'This will delete the theme with ID 123 permanently from your store. Make sure you have a backup if needed.',
+            command: '<%= config.bin %> <%= command.id %> 123'
+        }
+    ];
+    static hidden = true;
+    static args = {
+        id: Args.string({
+            description: 'Theme id',
+            name: 'id',
+            required: false,
+            type: 'string'
+        })
+    };
+    async run() {
+        const themeId = this.args.id;
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const executionContextApi = this.getApi(EXECUTION_CONTEXT_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        if (!credentials) {
+            renderOnce(React.createElement(MissingCredentialsError, null));
+            return;
+        }
+        const executionContext = await executionContextApi.getExecutionContext();
+        try {
+            let _themeId = themeId;
+            if (executionContext.type !== EXECUTION_CONTEXTS.theme && !_themeId) {
+                renderOnce(React.createElement(MissingThemeIdError, null,
+                    React.createElement(Box, { flexDirection: "column", gap: 1 },
+                        React.createElement(Text, null, "Usage: shoper theme delete [ID]"),
+                        React.createElement(Text, null, "Please run this command inside a theme directory or provide a theme ID."))));
+                return;
+            }
+            if (executionContext.type === EXECUTION_CONTEXTS.theme)
+                _themeId = _themeId ?? executionContext.themeId;
+            if (!_themeId) {
+                renderOnce(React.createElement(MissingThemeIdError, null));
+                return;
+            }
+            const themeActionsApi = this.getApi(THEME_ACTIONS_API_NAME);
+            const deleteAction = themeActionsApi.getThemeAction({
+                actionType: THEME_ACTIONS_TYPES.delete,
+                themeId: _themeId,
+                credentials
+            });
+            if (!deleteAction) {
+                renderOnce(React.createElement(UnpermittedCommandError, { themeId: _themeId, commandName: "delete" }));
+                return;
+            }
+            renderOnce(React.createElement(ThemeDeletionWarning, { themeId: _themeId }));
+            const { proceed } = await promptConfirmation('Proceed?');
+            if (!proceed) {
+                renderOnce(React.createElement(Info, { header: "Theme deletion was cancelled." }));
+                return;
+            }
+            const themeDeleteApi = this.getApi(THEME_DELETE_API_NAME);
+            const resp = await themeDeleteApi.deleteTheme({
+                actionData: deleteAction.data,
+                credentials
+            });
+            themeActionsApi.removeThemeActions({
+                themeId: _themeId,
+                credentials
+            });
+            if (!resp?.isSuccess)
+                return;
+            renderOnce(React.createElement(ThemeDeletedSuccessfully, null));
+            return;
+        }
+        catch (err) {
+            renderOnce(React.createElement(ThemeError, { err: err, executionContext: executionContext }));
+            return;
+        }
+    }
+}

package/build/theme/commands/delete/ui/theme_deleted_successfully.js

@@ -0,0 +1,15 @@
+import React from 'react';
+import { Text } from '../../../../ui/text.js';
+import { List } from '../../../../ui/list/list.js';
+import { Tip } from '../../../../ui/tip.js';
+import { Success } from '../../../../ui/message_box/success.js';
+export const ThemeDeletedSuccessfully = () => {
+    return (React.createElement(Success, { header: "Success: Theme was deleted from the store." },
+        React.createElement(Text, null, "The theme is no longer available in your store panel, but its files remain locally."),
+        React.createElement(Tip, null, "If you want to reuse this theme:"),
+        React.createElement(List, { items: [
+                'create a new theme using shoper theme init [id]',
+                'copy the local files into the new theme folder',
+                'and push it using shoper theme push'
+            ] })));
+};

package/build/theme/commands/delete/ui/theme_deletion_warning.js

@@ -0,0 +1,10 @@
+import { Warning } from '../../../../ui/message_box/warning.js';
+import { Text } from '../../../../ui/text.js';
+import React from 'react';
+export const ThemeDeletionWarning = ({ themeId }) => {
+    return (React.createElement(Warning, { header: `Warning: This will permanently delete the theme (ID: ${themeId}) from your store and cannot be undone.` },
+        React.createElement(Text, null,
+            "Your local files ",
+            React.createElement(Text, { bold: true }, "will not be removed"),
+            ". You\u2019ll still be able to access and modify them.")));
+};

package/build/theme/commands/info/theme_info_command.js

@@ -0,0 +1,79 @@
+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 { renderOnce } from '../../../ui/ui_utils.js';
+import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_credentials_error.js';
+import React from 'react';
+import { THEMES_LIST_API_NAME } from '../../features/themes/list/themes_list_constants.js';
+import { Args } from '@oclif/core';
+import { ThemeMetaDataUtils } from '../../features/theme/utils/meta_data/theme_meta_data_utils.js';
+import { MissingThemeIdError } from '../ui/missing_theme_id_error.js';
+import { Text } from '../../../ui/text.js';
+import { Error } from '../../../ui/message_box/error.js';
+import { Table } from '../../../ui/table/table.js';
+import { ThemeInfoCommandUtils } from './theme_info_command_utils.js';
+import { InvalidThemeIdError } from '../ui/invalid_theme_id.js';
+import { Box } from '../../../ui/box.js';
+import { ThemeError } from '../ui/theme_error.js';
+export class ThemeInfoCommand extends BaseThemeCommand {
+    static summary = 'View details about the current theme.';
+    static description = 'Displays key information about the theme you’re working on — including its ID, name, description (if provided), and status.\n\nYou can run this command from a specific theme directory (ID not needed) or outside any theme directory (theme ID required).';
+    static examples = [
+        {
+            description: 'The command will display the theme ID, name, description, and status.',
+            command: '<%= config.bin %> <%= command.id %> 2'
+        }
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Theme id',
+            name: 'id',
+            type: 'string'
+        })
+    };
+    async run() {
+        const themeId = this.args.id;
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const executionContextApi = this.getApi(EXECUTION_CONTEXT_API_NAME);
+        const themesListApi = this.getApi(THEMES_LIST_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        if (!credentials) {
+            renderOnce(React.createElement(MissingCredentialsError, null));
+            return;
+        }
+        const executionContext = await executionContextApi.getExecutionContext();
+        try {
+            let _themeId = themeId;
+            if (executionContext.type !== EXECUTION_CONTEXTS.theme && !_themeId) {
+                renderOnce(React.createElement(MissingThemeIdError, null,
+                    React.createElement(Box, { flexDirection: "column", gap: 1 },
+                        React.createElement(Text, null, "Usage: shoper theme info [ID]"),
+                        React.createElement(Text, null, "Please run this command inside a theme directory or provide a theme ID."))));
+                return;
+            }
+            if (executionContext.type === EXECUTION_CONTEXTS.theme) {
+                await ThemeMetaDataUtils.ensureThemeWorkUrlMatch(executionContext.themeRootDir, credentials.shopUrl);
+                _themeId = themeId ?? executionContext.themeId;
+            }
+            if (!_themeId) {
+                renderOnce(React.createElement(MissingThemeIdError, null));
+                return;
+            }
+            const theme = await themesListApi.getTheme({
+                themeId: _themeId,
+                shopUrl: credentials.shopUrl
+            });
+            if (!theme) {
+                renderOnce(_themeId ? React.createElement(InvalidThemeIdError, { themeId: _themeId }) : React.createElement(Error, { header: "Error: Theme information is not available." }));
+                return;
+            }
+            this._displayThemeInfo(theme);
+        }
+        catch (err) {
+            renderOnce(React.createElement(ThemeError, { err: err, executionContext: executionContext }));
+        }
+    }
+    _displayThemeInfo(theme) {
+        renderOnce(React.createElement(Table, { data: ThemeInfoCommandUtils.mapThemeMetaDataToTableData(theme) }));
+    }
+}

package/build/theme/commands/info/theme_info_command_utils.js

@@ -0,0 +1,39 @@
+import { Text } from '../../../ui/text.js';
+import React from 'react';
+export class ThemeInfoCommandUtils {
+    static mapThemeMetaDataToTableData(theme) {
+        return {
+            headers: [
+                {
+                    content: 'Theme Info'
+                }
+            ],
+            rows: [
+                [
+                    React.createElement(Text, null,
+                        React.createElement(Text, { bold: true }, "ID:"),
+                        " ",
+                        theme.skinId)
+                ],
+                [
+                    React.createElement(Text, null,
+                        React.createElement(Text, { bold: true }, "Name:"),
+                        " ",
+                        theme.title)
+                ],
+                [
+                    React.createElement(Text, null,
+                        React.createElement(Text, { bold: true }, "Description:"),
+                        " ",
+                        theme.description ? theme.description : '-')
+                ],
+                [
+                    React.createElement(Text, null,
+                        React.createElement(Text, { bold: true }, "Status: "),
+                        ": ",
+                        theme.isActive ? 'Active' : 'Inactive')
+                ]
+            ]
+        };
+    }
+}

package/build/theme/commands/init/theme_init_command.js

@@ -0,0 +1,84 @@
+import { BaseThemeCommand } from '../../class/base_theme_command.js';
+import { Args } from '@oclif/core';
+import { THEME_INIT_API_NAME } from '../../features/theme/init/theme_init_constants.js';
+import { CLI_AUTH_API_NAME } from '../../../cli/auth/cli_auth_constants.js';
+import ora from 'ora';
+import { EXECUTION_CONTEXT_API_NAME, EXECUTION_CONTEXTS } from '../../../cli/features/execution_context/execution_context_constants.js';
+import { THEME_ACTIONS_API_NAME, THEME_ACTIONS_TYPES } from '../../features/theme/actions/theme_actions_constants.js';
+import { renderOnce } from '../../../ui/ui_utils.js';
+import { ThemeDirectoryContextError } from '../ui/theme_directory_context_error.js';
+import React from 'react';
+import { UnpermittedCommandError } from '../ui/unpermitted_command_error.js';
+import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_credentials_error.js';
+import { ThemeCreatedSuccess } from './ui/theme_created_success.js';
+import { Text } from '../../../ui/text.js';
+import { MissingThemeIdError } from '../ui/missing_theme_id_error.js';
+import { Box } from '../../../ui/box.js';
+import { ThemeError } from '../ui/theme_error.js';
+export class ThemeInitCommand extends BaseThemeCommand {
+    static summary = 'Creates a copy of an existing theme by duplicating it.';
+    static description = 'The new theme will be named after the source theme with a "Copy" suffix and an incremental number.\n\nYou must run this command from the root directory (not inside any theme folder) and provide the ID of the theme you want to duplicate.';
+    static examples = [
+        {
+            description: 'This will duplicate the theme with ID 123 (named SourceTheme Copy 3) and create a new theme named "SourceTheme Copy 4".\nUse this as a starting point for your customizations.\n',
+            command: '<%= config.bin %> <%= command.id %> 123'
+        }
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Theme id',
+            name: 'id',
+            required: false,
+            type: 'string'
+        })
+    };
+    async run() {
+        const themeId = this.args.id;
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const themeInitApi = this.getApi(THEME_INIT_API_NAME);
+        const themeActionsApi = this.getApi(THEME_ACTIONS_API_NAME);
+        const executionContextApi = this.getApi(EXECUTION_CONTEXT_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        if (!credentials) {
+            renderOnce(React.createElement(MissingCredentialsError, null));
+            return;
+        }
+        const executionContext = await executionContextApi.getExecutionContext();
+        if (executionContext.type === EXECUTION_CONTEXTS.theme) {
+            renderOnce(React.createElement(ThemeDirectoryContextError, null));
+            return;
+        }
+        if (!themeId) {
+            this._renderMissingThemeIdError();
+            return;
+        }
+        let spinner;
+        try {
+            const copyAction = themeActionsApi.getThemeAction({
+                actionType: THEME_ACTIONS_TYPES.copy,
+                themeId,
+                credentials
+            });
+            if (!copyAction) {
+                renderOnce(React.createElement(UnpermittedCommandError, { themeId: themeId, commandName: "init" }));
+                return;
+            }
+            spinner = ora('Creating theme...').start();
+            const { themeId: createdThemeId, themeName } = await themeInitApi.initTheme({ action: copyAction, credentials });
+            spinner.stop();
+            renderOnce(React.createElement(ThemeCreatedSuccess, { createdThemeId: createdThemeId, themeName: themeName }));
+        }
+        catch (err) {
+            spinner?.stop();
+            renderOnce(React.createElement(ThemeError, { err: err, executionContext: executionContext }));
+            //TODO analyze why on nodejs v22 this command does not exit properly, even all promises are resolved
+            this.exit();
+        }
+    }
+    _renderMissingThemeIdError() {
+        renderOnce(React.createElement(MissingThemeIdError, null,
+            React.createElement(Box, { flexDirection: "column", gap: 1 },
+                React.createElement(Text, null, "Usage: shoper theme init [ID]"),
+                React.createElement(Text, null, "This command creates a copy of an existing theme based on its ID.To proceed, you must provide the ID of the theme you want to duplicate."))));
+    }
+}

package/build/theme/commands/init/ui/theme_created_success.js

@@ -0,0 +1,15 @@
+import { Box } from '../../../../ui/box.js';
+import { Text } from '../../../../ui/text.js';
+import { Success } from '../../../../ui/message_box/success.js';
+import React from 'react';
+export const ThemeCreatedSuccess = ({ createdThemeId, themeName }) => {
+    return (React.createElement(Success, { header: "Success: Theme was created!" },
+        React.createElement(Box, { gap: 1, flexDirection: "column" },
+            React.createElement(Text, null,
+                "Theme \"",
+                themeName,
+                "\" was created (ID: ",
+                createdThemeId,
+                ")."),
+            React.createElement(Text, null, "You can now customize your new theme."))));
+};

package/build/theme/commands/list/theme_list_command.js

@@ -0,0 +1,25 @@
+import { BaseThemeCommand } from '../../class/base_theme_command.js';
+import { THEMES_LIST_API_NAME } from '../../features/themes/list/themes_list_constants.js';
+import { CLI_AUTH_API_NAME } from '../../../cli/auth/cli_auth_constants.js';
+import { renderOnce } from '../../../ui/ui_utils.js';
+import { Info } from '../../../ui/message_box/info.js';
+import React from 'react';
+import { Table } from '../../../ui/table/table.js';
+import { ThemeListCommandUtils } from './theme_list_command_utils.js';
+export class ThemeListCommand extends BaseThemeCommand {
+    static summary = 'Displays a list of all themes available in your store, including their IDs, names, and statuses (active/inactive).';
+    static description = 'Use this to check which theme is now active in your store.';
+    async run() {
+        const ThemesListApi = this.getApi(THEMES_LIST_API_NAME);
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        if (!credentials)
+            this.error('Credentials not found. Please authorize first.');
+        const themes = await ThemesListApi.getThemes(credentials);
+        if (!themes?.length) {
+            renderOnce(React.createElement(Info, { header: "No themes found for this store." }));
+            return;
+        }
+        renderOnce(React.createElement(Table, { data: ThemeListCommandUtils.mapThemeListToTableData(themes) }));
+    }
+}

package/build/theme/commands/list/theme_list_command_utils.js

@@ -0,0 +1,27 @@
+import React from 'react';
+import { Text } from '../../../ui/text.js';
+export class ThemeListCommandUtils {
+    static mapThemeListToTableData(themes) {
+        return {
+            headers: [
+                {
+                    content: 'Theme ID',
+                    width: 10
+                },
+                {
+                    content: 'Theme Name',
+                    width: 70
+                },
+                {
+                    content: 'Status',
+                    width: 10
+                }
+            ],
+            rows: themes.map((theme) => [
+                React.createElement(Text, null, theme.skinId),
+                React.createElement(Text, null, theme.title),
+                React.createElement(Text, null, theme.isActive ? 'active' : 'inactive')
+            ])
+        };
+    }
+}

package/build/theme/commands/publish/theme_publish_command.js

@@ -0,0 +1,76 @@
+import { Args } from '@oclif/core';
+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 { renderOnce } from '../../../ui/ui_utils.js';
+import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_credentials_error.js';
+import React from 'react';
+import { MissingThemeIdError } from '../ui/missing_theme_id_error.js';
+import { THEME_SKINSTORE_API_NAME } from '../../features/theme/skinstore/theme_publish_constants.js';
+import { Form } from '../../../cli/features/controls/ui/form.js';
+import { ThemeError } from '../ui/theme_error.js';
+export class ThemePublishCommand extends BaseThemeCommand {
+    static summary = 'Permanently deletes the specified theme from your store.';
+    static description = 'This action cannot be undone, so make sure you really want to remove this theme.\n\nYou can run this command from a specific theme directory (ID not needed) or outside any theme directory (theme ID required).';
+    static examples = [
+        {
+            description: 'This will delete the theme with ID 123 permanently from your store. Make sure you have a backup if needed.',
+            command: '<%= config.bin %> <%= command.id %> 123'
+        }
+    ];
+    static hidden = true;
+    static args = {
+        id: Args.string({
+            description: 'Theme id',
+            name: 'id',
+            required: false,
+            type: 'string'
+        })
+    };
+    async run() {
+        const themeId = this.args.id;
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const executionContextApi = this.getApi(EXECUTION_CONTEXT_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        if (!credentials) {
+            renderOnce(React.createElement(MissingCredentialsError, null));
+            return;
+        }
+        const executionContext = await executionContextApi.getExecutionContext();
+        try {
+            let _themeId = themeId;
+            if (executionContext.type !== EXECUTION_CONTEXTS.theme && !_themeId) {
+                return;
+            }
+            if (executionContext.type === EXECUTION_CONTEXTS.theme) {
+                _themeId = _themeId ?? executionContext.themeId;
+            }
+            if (!_themeId) {
+                renderOnce(React.createElement(MissingThemeIdError, null));
+                return;
+            }
+            const themeActionsApi = this.getApi(THEME_ACTIONS_API_NAME);
+            const themeSkinstoreApi = this.getApi(THEME_SKINSTORE_API_NAME);
+            const pushAction = themeActionsApi.getThemeAction({
+                actionType: THEME_ACTIONS_TYPES.publishForm,
+                themeId: _themeId,
+                credentials
+            });
+            const controls = await themeSkinstoreApi.getPublishFormData({
+                actionData: pushAction.data,
+                credentials
+            });
+            Form({
+                controls,
+                onSubmit: (formData) => {
+                    console.log('formData', formData);
+                }
+            });
+        }
+        catch (err) {
+            renderOnce(React.createElement(ThemeError, { err: err, executionContext: executionContext }));
+            return;
+        }
+    }
+}

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

@@ -0,0 +1,174 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseThemeCommand } from '../../class/base_theme_command.js';
+import { THEME_FETCH_API_NAME, THEME_FETCH_TYPES } from '../../features/theme/fetch/theme_fetch_constants.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 ora from 'ora';
+import { THEME_MERGE_API_NAME } from '../../features/theme/merge/theme_merge_constants.js';
+import tmp from 'tmp-promise';
+import { join } from '../../../utils/path_utils.js';
+import { THEME_ACTIONS_API_NAME, THEME_ACTIONS_TYPES } from '../../features/theme/actions/theme_actions_constants.js';
+import process from 'node:process';
+import { ThemeResourcesWithIdDirectoryUtils } from '../../features/theme/utils/resources/theme_resources_with_id_directory_utils.js';
+import { renderOnce } from '../../../ui/ui_utils.js';
+import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_credentials_error.js';
+import React from 'react';
+import { MissingThemeIdError } from '../ui/missing_theme_id_error.js';
+import { Text } from '../../../ui/text.js';
+import { UnpermittedCommandError } from '../ui/unpermitted_command_error.js';
+import { ThemePullIdMismatchError } from './ui/theme_pull_id_mismatch_error.js';
+import { ThemePullUnpublishedChangesWarning } from './ui/theme_pull_unpublished_changes_warning.js';
+import { promptConfirmation } from '../../../ui/prompts/prompt_confirmation.js';
+import { ThemePulledSuccess } from './ui/theme_pulled_success.js';
+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'; //TODO jak jest error w pullu wowczas usuwamy docelowo pociagniety skin
+//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.';
+    static description = 'Make sure to back up any local modifications you wish to keep.\n\nYou can run this command from a specific theme directory (ID not needed) or outside any theme directory (theme ID required).\n\nThis keeps your local theme the same as the version in your store.';
+    static examples = [
+        {
+            description: 'This will update your local theme files with the current version from the store.',
+            command: '<%= config.bin %> <%= command.id %>'
+        },
+        {
+            description: 'This will download the theme with ID "2" from the store.',
+            command: '<%= config.bin %> <%= command.id %> 2'
+        }
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Theme id',
+            name: 'id',
+            type: 'string'
+        })
+    };
+    static flags = {
+        type: Flags.string({
+            default: THEME_FETCH_TYPES.full,
+            description: 'Type of theme to pull',
+            options: Object.values(THEME_FETCH_TYPES)
+        })
+    };
+    #spinner;
+    async run() {
+        const themeId = this.args.id;
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const themeFetchApi = this.getApi(THEME_FETCH_API_NAME);
+        const executionContextApi = this.getApi(EXECUTION_CONTEXT_API_NAME);
+        const themeActionsApi = this.getApi(THEME_ACTIONS_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        if (!credentials) {
+            renderOnce(React.createElement(MissingCredentialsError, null));
+            return;
+        }
+        const executionContext = await executionContextApi.getExecutionContext();
+        let _themeId = themeId;
+        try {
+            if (executionContext.type !== EXECUTION_CONTEXTS.theme) {
+                await this._pullNewTheme({
+                    themeId,
+                    themeFetchApi,
+                    themeActionsApi,
+                    credentials,
+                    fetchType: this.flags.type
+                });
+            }
+            if (executionContext.type === EXECUTION_CONTEXTS.theme) {
+                _themeId = themeId ? themeId : executionContext.themeId;
+                await this._pullThemeIntoExistingOne({
+                    themeId: _themeId,
+                    themeFetchApi,
+                    themeActionsApi,
+                    fetchType: this.flags.type,
+                    executionContext,
+                    credentials
+                });
+            }
+        }
+        catch (err) {
+            this.#spinner?.stop();
+            renderOnce(React.createElement(ThemeError, { err: err, executionContext: executionContext }));
+        }
+    }
+    _renderUnpermittedCommandError(themeId) {
+        renderOnce(React.createElement(UnpermittedCommandError, { themeId: themeId, commandName: "pull" }));
+    }
+    async _pullNewTheme({ themeId, themeFetchApi, themeActionsApi, credentials, fetchType }) {
+        if (themeId === undefined) {
+            renderOnce(React.createElement(MissingThemeIdError, null,
+                React.createElement(Text, null, "Usage: shoper theme pull [ID]")));
+            return;
+        }
+        const pullAction = themeActionsApi.getThemeAction({
+            actionType: THEME_ACTIONS_TYPES.pull,
+            themeId,
+            credentials
+        });
+        if (!pullAction) {
+            this._renderUnpermittedCommandError(themeId);
+            return;
+        }
+        this.#spinner = ora('Pulling theme...').start();
+        await themeFetchApi.fetchTheme({
+            credentials,
+            action: pullAction,
+            config: {
+                dist: process.cwd(),
+                fetchType
+            }
+        });
+        this.#spinner.stop();
+        renderOnce(React.createElement(ThemePulledSuccess, null));
+    }
+    async _pullThemeIntoExistingOne({ themeId, themeFetchApi, themeActionsApi, fetchType, executionContext, credentials }) {
+        //TODO move these logi somvewhere else?
+        await ThemeMetaDataUtils.ensureThemeWorkUrlMatch(executionContext.themeRootDir, credentials.shopUrl);
+        const pullAction = themeActionsApi.getThemeAction({
+            actionType: THEME_ACTIONS_TYPES.pull,
+            themeId,
+            credentials
+        });
+        if (!pullAction) {
+            this._renderUnpermittedCommandError(themeId);
+            return;
+        }
+        if (executionContext.themeId !== themeId) {
+            renderOnce(React.createElement(ThemePullIdMismatchError, { providedThemeId: themeId, currentThemeId: executionContext.themeId }));
+            return;
+        }
+        const themeMergeApi = this.getApi(THEME_MERGE_API_NAME);
+        const { path: tmpDir } = await tmp.dir({ unsafeCleanup: true });
+        this.#spinner = ora('Pulling theme...').start();
+        const { name } = await themeFetchApi.fetchTheme({
+            credentials,
+            action: pullAction,
+            config: {
+                fetchType,
+                dist: tmpDir
+            }
+        });
+        const localModulesPath = join(executionContext.themeRootDir, 'modules');
+        const fetchedThemePath = join(tmpDir, name);
+        const fetchedModulesPath = join(fetchedThemePath, 'modules');
+        if ((await directoryExists(localModulesPath)) && (await directoryExists(fetchedModulesPath)))
+            await ThemeResourcesWithIdDirectoryUtils.updateDirectoryNamesOfResourcesWithIdAccordingToLocalThemeNames(localModulesPath, fetchedModulesPath, fetchedThemePath);
+        this.#spinner.stop();
+        const changes = await themeMergeApi.getChangesBetweenThemes(fetchedThemePath, executionContext.themeRootDir);
+        const themeChecksums = new ThemeChecksums(executionContext.themeRootDir);
+        if (changes.length && (await themeChecksums.hasThemeBeenModified())) {
+            renderOnce(React.createElement(ThemePullUnpublishedChangesWarning, { changes: changes }));
+            const { proceed } = await promptConfirmation('Do you want to continue and overwrite local changes?');
+            if (!proceed) {
+                renderOnce(React.createElement(Info, null,
+                    React.createElement(Text, null, "Pull operation cancelled. Your local changes are safe.")));
+                return;
+            }
+        }
+        await themeMergeApi.applyChanges(join(tmpDir, name), executionContext.themeRootDir, changes);
+        renderOnce(React.createElement(ThemePulledSuccess, null));
+    }
+}

package/build/theme/commands/pull/ui/theme_pull_id_mismatch_error.js

@@ -0,0 +1,7 @@
+import React from 'react';
+import { Error } from '../../../../ui/message_box/error.js';
+import { Text } from '../../../../ui/text.js';
+export const ThemePullIdMismatchError = ({ providedThemeId, currentThemeId }) => {
+    return (React.createElement(Error, { header: `Error: Provided ID (${providedThemeId}) doesn't match the current theme directory (${currentThemeId}).` },
+        React.createElement(Text, null, "Please move outside the theme directory and run the command again with the correct ID.")));
+};