@shoper/cli 0.5.2 → 0.6.0

package/README.md

@@ -1,3 +1,5 @@
-# shoper-cli
+![Shoper CLI](.docs/images/shoper-for-developers.svg)
 
-Comming soon...
+# Shoper CLI
+
+Learn more in the [commands docs](https://storefront.developers.shoper.pl/cli/)

package/build/cli/auth/cli_auth_errors_factory.js

@@ -1,4 +1,4 @@
-import { AppError } from '../class/errors/app/app_error.js';
+import { AppError } from '../utilities/features/logger/logs/app_error.js';
 export class CliAuthErrorsFactory {
     static createCredentialNotFoundError() {
         return new AppError({

package/build/cli/auth/cli_auth_initializer.js

@@ -3,15 +3,20 @@ import { CliAuthService } from './service/cli_auth_service.js';
 import { CliAuthApi } from './api/cli_auth_api.js';
 import { CLI_AUTH_TOKENS_API_NAME } from './tokens/cli_auth_tokens_constants.js';
 import { CLI_AUTH_FEATURE_NAME } from './cli_auth_constants.js';
+import { LOGGER_API_NAME } from '../utilities/features/logger/logger_constants.js';
 export class CliAuthInitializer extends SyncFeatureInitializer {
     static featureName = CLI_AUTH_FEATURE_NAME;
     init() {
         const cliAuthTokensApi = this.getApiSync(CLI_AUTH_TOKENS_API_NAME);
+        const loggerApi = this.getApiSync(LOGGER_API_NAME);
         return {
             cores: [
                 {
                     type: FEATURE_CORES_TYPES.api,
-                    instance: new CliAuthApi(new CliAuthService(cliAuthTokensApi))
+                    instance: new CliAuthApi(new CliAuthService({
+                        cliAuthTokensApi,
+                        loggerApi
+                    }))
                 }
             ]
         };

package/build/cli/auth/service/cli_auth_service.js

@@ -3,27 +3,35 @@ import { CliAuthErrorsFactory } from '../cli_auth_errors_factory.js';
 export class CliAuthService {
     #cliAuthTokensApi;
     #credentials = null;
-    constructor(cliAuthTokensApi) {
+    #loggerApi;
+    constructor({ loggerApi, cliAuthTokensApi }) {
         this.#cliAuthTokensApi = cliAuthTokensApi;
+        this.#loggerApi = loggerApi;
         this._setCredentials();
     }
     _setCredentials() {
+        this.#loggerApi.debug('Setting credentials from default token.');
         const defaultTokenPayload = this.#cliAuthTokensApi.getDefaultTokenPayload();
-        if (!defaultTokenPayload)
+        if (!defaultTokenPayload) {
+            this.#loggerApi.debug('No default token payload found. Credentials not set.');
             return;
+        }
         this.#credentials = new CliCredentials({
             shopUrl: defaultTokenPayload.iss,
             scopes: defaultTokenPayload.scope.split(';'),
             expires: defaultTokenPayload.exp
         });
+        this.#loggerApi.debug('Credentials set successfully.');
     }
     getCredentials() {
+        this.#loggerApi.debug('Getting credentials.');
         if (this.#credentials)
             return this.#credentials;
         this._setCredentials();
         return this.#credentials;
     }
     hasCredentialsExpired() {
+        this.#loggerApi.debug('Checking if credentials have expired.');
         if (!this.#credentials)
             throw CliAuthErrorsFactory.createCredentialNotFoundError();
         const defaultTokenIndex = this.#cliAuthTokensApi.getDefaultTokenIndex();
@@ -32,6 +40,7 @@ export class CliAuthService {
         return this.#cliAuthTokensApi.hasTokenExpired(defaultTokenIndex);
     }
     clearCredentials() {
+        this.#loggerApi.debug('Clearing credentials and tokens.');
         this.#credentials = null;
         this.#cliAuthTokensApi.clearTokens();
     }

package/build/cli/auth/tokens/cli_auth_tokens_errors_factory.js

@@ -1,4 +1,4 @@
-import { AppError } from '../../class/errors/app/app_error.js';
+import { AppError } from '../../utilities/features/logger/logs/app_error.js';
 export class CliAuthTokensErrorsFactory {
     static createTokenNotFoundError(index) {
         return new AppError({

package/build/cli/auth/tokens/cli_auth_tokens_initalizer.js

@@ -4,6 +4,7 @@ import { CLiAuthTokensService } from './service/cli_auth_tokens_service.js';
 import { CLI_AUTH_TOKENS_FEATURE_NAME, CLI_AUTH_TOKENS_FILE_NAME } from './cli_auth_tokens_constants.js';
 import { CLI_DATA_DIRECTORY_API_NAME } from '../../features/data_directory/cli_data_directory_constants.js';
 import { JsonCache } from '../../class/caches/json_cache/json_cache.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
 // schema
 // {
 //     default: string;
@@ -18,6 +19,7 @@ export class CliAuthTokensInitializer extends SyncFeatureInitializer {
     static featureName = CLI_AUTH_TOKENS_FEATURE_NAME;
     init() {
         const cliDataDirectoryApi = this.getApiSync(CLI_DATA_DIRECTORY_API_NAME);
+        const loggerApi = this.getApiSync(LOGGER_API_NAME);
         const tokensStore = new JsonCache({
             path: cliDataDirectoryApi.getDataDirectoryFullPath(),
             configFileMode: 0o600,
@@ -27,7 +29,10 @@ export class CliAuthTokensInitializer extends SyncFeatureInitializer {
             cores: [
                 {
                     type: FEATURE_CORES_TYPES.api,
-                    instance: new CliAuthTokensApi(new CLiAuthTokensService(tokensStore))
+                    instance: new CliAuthTokensApi(new CLiAuthTokensService({
+                        tokensStore,
+                        loggerApi
+                    }))
                 }
             ]
         };

package/build/cli/auth/tokens/service/cli_auth_tokens_service.js

@@ -4,10 +4,13 @@ import { CLI_AUTH_DEFAULT_TOKEN_NAME, CLI_AUTH_TOKENS_KEY } from './cli_auth_tok
 import { CliAuthTokensErrorsFactory } from '../cli_auth_tokens_errors_factory.js';
 export class CLiAuthTokensService {
     #tokensStore;
-    constructor(tokensStore) {
+    #loggerApi;
+    constructor({ tokensStore, loggerApi }) {
         this.#tokensStore = tokensStore;
+        this.#loggerApi = loggerApi;
     }
     addToken(token) {
+        this.#loggerApi.debug('Adding new token.');
         const tokeItem = {
             token,
             type: CLI_AUTH_TOKENS_TYPES.jwt
@@ -17,12 +20,14 @@ export class CLiAuthTokensService {
         this._setTokens(tokens);
     }
     validateToken(token) {
+        this.#loggerApi.debug('Validating token.');
         return CLiAuthTokensUtils.isValidJWT(token);
     }
     hasToken(index) {
         return index <= this.getTokensCount();
     }
     removeToken(index) {
+        this.#loggerApi.debug('Removing token.', { details: { index } });
         if (!this.hasToken(index))
             return;
         const tokens = this._getTokenItems();
@@ -54,6 +59,7 @@ export class CLiAuthTokensService {
      * Index starts from 1
      */
     setDefaultToken(index) {
+        this.#loggerApi.debug('Setting default token.', { details: { index } });
         const tokens = this._getTokenItems();
         if (tokens.length < index)
             throw CliAuthTokensErrorsFactory.createTokenNotFoundError(index);
@@ -87,6 +93,7 @@ export class CLiAuthTokensService {
         return tokens.map((tokenItem) => CLiAuthTokensUtils.getTokenPayload(tokenItem.token));
     }
     clearTokens() {
+        this.#loggerApi.debug('Clearing all tokens.');
         this.#tokensStore.clear();
     }
 }

package/build/cli/class/base_command.js

@@ -1,10 +1,24 @@
-import { Command } from '@oclif/core';
+import { Command, Flags } from '@oclif/core';
 import { API_RESOLVER_QUERIES, AppError, getStarCoreEnvironment, QueryMessage } from '@dreamcommerce/star_core';
 export class BaseCommand extends Command {
     queryBus;
     commandBus;
     eventBus;
     globalCoresContainersRegistry;
+    static baseFlags = {
+        v: Flags.boolean({
+            default: false,
+            summary: 'Enable verbose output'
+        }),
+        vv: Flags.boolean({
+            default: false,
+            summary: 'Enable very verbose output'
+        }),
+        'log-file': Flags.boolean({
+            default: false,
+            summary: 'Save log to file in the current directory. E.g., --log-file'
+        })
+    };
     flags;
     args;
     constructor(argv, config) {

package/build/cli/class/cli_help.js

@@ -0,0 +1,24 @@
+import { Help } from '@oclif/core';
+import figlet from 'figlet';
+import { renderOnce } from '../../ui/ui_utils.js';
+import { Gradient } from '../../ui/gradient.js';
+import React from 'react';
+import { Text } from '../../ui/text.js';
+export default class CliHelp extends Help {
+    async showCommandHelp(cmd) {
+        this._showBanner();
+        super.showCommandHelp(cmd);
+    }
+    async showTopicHelp(topic) {
+        this._showBanner();
+        super.showTopicHelp(topic);
+    }
+    async showRootHelp() {
+        this._showBanner();
+        super.showRootHelp();
+    }
+    _showBanner() {
+        renderOnce(React.createElement(Gradient, { name: "retro" },
+            React.createElement(Text, null, figlet.textSync('Shoper CLI', { font: 'ANSI Regular' }))));
+    }
+}

package/build/cli/class/errors/file_system_errors_factory.js

@@ -1,4 +1,4 @@
-import { AppError } from './app/app_error.js';
+import { AppError } from '../../utilities/features/logger/logs/app_error.js';
 export class FileSystemErrorsFactory {
     static createDiskFullError() {
         return new AppError({
@@ -12,7 +12,7 @@ export class FileSystemErrorsFactory {
             code: 'file_system.error_moving_file',
             message: `Failed to move file from ${source} to ${destination}`,
             level: 'error',
-            stack: err.stack
+            error: err
         });
     }
     static createErrorCopyingFile(source, destination, err) {
@@ -20,7 +20,7 @@ export class FileSystemErrorsFactory {
             code: 'file_system.error_copying_file',
             message: `Failed to copy file from ${source} to ${destination}`,
             level: 'error',
-            stack: err.stack
+            error: err
         });
     }
 }

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

@@ -1,4 +1,4 @@
-import { AppError } from '../app/app_error.js';
+import { AppError } from '../../../utilities/features/logger/logs/app_error.js';
 import { HTTP_NOT_FOUND_ERROR_CODE } from './http_errors_constants.js';
 export class HttpErrorsFactory {
     static createUnauthorizedError() {

package/build/cli/commands/auth/cli_auth_add_token_command.js

@@ -8,12 +8,14 @@ import { Box } from '../../../ui/box.js';
 import { Command } from '../../../ui/command.js';
 import React from 'react';
 import { Error } from '../../../ui/message_box/error.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
 export class CliAuthAddTokenCommand extends BaseCliCommand {
     static summary = 'Adds a new authentication token and saves it locally.';
     static description = 'The added token will be set as your default authentication token.\n\nUse this when you’ve generated a token in your store panel and want to authenticate your CLI commands.';
     static examples = ['<%= config.bin %> <%= command.id %>'];
     async run() {
         const cliAuthTokensApi = this.getApi(CLI_AUTH_TOKENS_API_NAME);
+        const loggerApi = this.getApi(LOGGER_API_NAME);
         try {
             const { input: token } = await promptInput('Please paste your CLI token:');
             const { isValid, message } = cliAuthTokensApi.validateToken(token);
@@ -34,6 +36,9 @@ export class CliAuthAddTokenCommand extends BaseCliCommand {
                         " to view your saved tokens."))));
         }
         catch (err) {
+            loggerApi.error('Error while adding auth token', {
+                error: err
+            });
             renderOnce(React.createElement(Error, { header: "Error: Failed to add token: " },
                 React.createElement(Box, null,
                     React.createElement(Text, null, err.toString()))));

package/build/cli/commands/auth/cli_auth_list_tokens_command.js

@@ -3,28 +3,37 @@ import { CLI_AUTH_TOKENS_API_NAME } from '../../auth/tokens/cli_auth_tokens_cons
 import React from 'react';
 import { CliAuthCommandsUtils } from './cli_auth_commands_utils.js';
 import { Table } from '../../../ui/table/table.js';
-import { render } from '../../../ui/ui_utils.js';
+import { render, renderOnce } from '../../../ui/ui_utils.js';
 import { Box } from '../../../ui/box.js';
 import { Tip } from '../../../ui/tip.js';
 import { Command } from '../../../ui/command.js';
 import { Text } from '../../../ui/text.js';
 import { Info } from '../../../ui/message_box/info.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
 export class CliAuthListTokensCommand extends BaseCliCommand {
     static summary = 'Displays a list of all authentication tokens stored locally.';
     static description = 'For each token, you’ll see its name, index, assigned store URL, access scope and expiration date.\n\nUse this to review your tokens and check which one is set as the default.';
     static examples = ['<%= config.bin %> <%= command.id %>'];
     async run() {
         const tokensApi = this.getApi(CLI_AUTH_TOKENS_API_NAME);
-        const tokensPayloads = tokensApi.getAllTokensPayloads();
-        if (!tokensPayloads.length) {
-            await render(React.createElement(Info, null,
-                React.createElement(Box, null,
-                    React.createElement(Text, null, "No tokens found")),
-                React.createElement(Tip, null,
-                    "Generate one using ",
-                    React.createElement(Command, null, "shoper auth add-token"))));
-            return;
+        const loggerApi = this.getApi(LOGGER_API_NAME);
+        try {
+            const tokensPayloads = tokensApi.getAllTokensPayloads();
+            if (!tokensPayloads.length) {
+                await render(React.createElement(Info, null,
+                    React.createElement(Box, null,
+                        React.createElement(Text, null, "No tokens found")),
+                    React.createElement(Tip, null,
+                        "Generate one using ",
+                        React.createElement(Command, null, "shoper auth add-token"))));
+                return;
+            }
+            renderOnce(React.createElement(Table, { data: CliAuthCommandsUtils.mapToTableData(tokensPayloads, tokensApi.getDefaultTokenIndex(), tokensApi) }));
+        }
+        catch (err) {
+            loggerApi.error('Error while listing auth tokens', {
+                error: err
+            });
         }
-        await render(React.createElement(Table, { data: CliAuthCommandsUtils.mapToTableData(tokensPayloads, tokensApi.getDefaultTokenIndex(), tokensApi) }));
     }
 }

package/build/cli/commands/auth/cli_auth_logout_command.js

@@ -7,17 +7,22 @@ import React from 'react';
 import { Error } from '../../../ui/message_box/error.js';
 import { Box } from '../../../ui/box.js';
 import { Text } from '../../../ui/text.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
 export class CliAuthLogoutCommand extends BaseCliCommand {
     static summary = 'Clears all stored CLI authentication data';
     async run() {
         const themeActionsApi = this.getApi(THEME_ACTIONS_API_NAME);
         const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const loggerApi = this.getApi(LOGGER_API_NAME);
         try {
             themeActionsApi.clearAllActions();
             cliAuthApi.clearCredentials();
             renderOnce(React.createElement(Success, { header: "Logout successful" }));
         }
         catch (err) {
+            loggerApi.error('Error while logging out', {
+                error: err
+            });
             renderOnce(React.createElement(Error, { header: "Logout failed" },
                 React.createElement(Box, null,
                     React.createElement(Text, null, err.toString()))));

package/build/cli/commands/auth/cli_auth_remove_token_command.js

@@ -13,6 +13,7 @@ import { Info } from '../../../ui/message_box/info.js';
 import { Success } from '../../../ui/message_box/success.js';
 import { Warning } from '../../../ui/message_box/warning.js';
 import { Error } from '../../../ui/message_box/error.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
 export class CliAuthRemoveTokenCommand extends BaseCliCommand {
     static summary = 'Removes a locally saved authentication token.';
     static description = 'Use this to clean up tokens you no longer need.';
@@ -30,6 +31,7 @@ export class CliAuthRemoveTokenCommand extends BaseCliCommand {
     };
     async run() {
         const cliAuthTokensApi = this.getApi(CLI_AUTH_TOKENS_API_NAME);
+        const loggerApi = this.getApi(LOGGER_API_NAME);
         const { index } = this.args;
         if (!index || !cliAuthTokensApi.hasToken(index)) {
             renderOnce(React.createElement(MissingTokenIndexError, { command: React.createElement(Command, null, "shoper auth remove-token [TOKEN_INDEX]") }));
@@ -53,6 +55,9 @@ export class CliAuthRemoveTokenCommand extends BaseCliCommand {
                 React.createElement(Text, null, "Token removal was cancelled.")));
         }
         catch (err) {
+            loggerApi.error('Error while removing auth token', {
+                error: err
+            });
             renderOnce(React.createElement(Error, { header: "Error: Failed to remove token: " },
                 React.createElement(Box, null,
                     React.createElement(Text, null, err.toString()))));

package/build/cli/commands/auth/cli_auth_switch_token_command.js

@@ -9,6 +9,7 @@ import { MissingTokenIndexError } from './ui/missing_token_index_error.js';
 import { Command } from '../../../ui/command.js';
 import { Error } from '../../../ui/message_box/error.js';
 import { Success } from '../../../ui/message_box/success.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
 export class CliAuthSwitchTokenCommand extends BaseCliCommand {
     static summary = 'Changes the active authentication token used by the CLI.';
     static description = 'Use this to switch between multiple saved tokens when working with different stores.';
@@ -26,6 +27,7 @@ export class CliAuthSwitchTokenCommand extends BaseCliCommand {
     };
     async run() {
         const cliAuthTokensApi = this.getApi(CLI_AUTH_TOKENS_API_NAME);
+        const loggerApi = this.getApi(LOGGER_API_NAME);
         const { index } = this.args;
         if (!index || !cliAuthTokensApi.hasToken(index)) {
             renderOnce(React.createElement(MissingTokenIndexError, { command: React.createElement(Command, null, "shoper auth switch-token [TOKEN_INDEX]") }));
@@ -37,6 +39,12 @@ export class CliAuthSwitchTokenCommand extends BaseCliCommand {
             renderOnce(React.createElement(Success, { header: `Success: Token "${defaultToken?.name}" assigned to "${defaultToken?.iss}" is now active` }));
         }
         catch (err) {
+            loggerApi.error('Failed to switch token', {
+                error: err,
+                details: {
+                    tokenIndex: index
+                }
+            });
             renderOnce(React.createElement(Error, { header: "Error: Failed to switch token: " },
                 React.createElement(Box, null,
                     React.createElement(Text, null, err.toString()))));

package/build/cli/commands/cli_update_command.js

@@ -4,12 +4,14 @@ import { BaseCliCommand } from '../class/base_cli_command.js';
 import { renderOnce } from '../../ui/ui_utils.js';
 import React from 'react';
 import { Error } from '../../ui/message_box/error.js';
+import { LOGGER_API_NAME } from '../utilities/features/logger/logger_constants.js';
 export class CliUpdateCommand extends BaseCliCommand {
     static summary = 'Update the Shoper CLI';
     static description = 'Update the Shoper CLI to the latest version.';
     static examples = [`$ shoper update`];
     async run() {
         const cliVersionApi = this.getApi(CLI_VERSION_API_NAME);
+        const loggerApi = this.getApi(LOGGER_API_NAME);
         try {
             const installedVersion = await cliVersionApi.getGloballyInstalledVersion();
             if (!installedVersion) {
@@ -23,6 +25,9 @@ export class CliUpdateCommand extends BaseCliCommand {
             this.log(stdout);
         }
         catch (error) {
+            loggerApi.error('Error while updating the CLI', {
+                error
+            });
             //npm code for EACCES
             if (error?.code === 243) {
                 renderOnce(React.createElement(Error, { header: error.message }));

package/build/cli/core/cli_setup.js

@@ -1,7 +1,7 @@
 import { getOSRootDirectory } from '../../utils/fs/fs_utils.js';
 import * as process from 'process';
 import tmp from 'tmp-promise';
-import { HTTPRequesterInitializer } from '../features/http_requester/http_requester_initializer.js';
+import { HTTPRequesterInitializer } from '../utilities/features/http_requester/http_requester_initializer.js';
 import { SanitizerInitializer, StarCoreSetup } from '@dreamcommerce/star_core';
 import { CliDataDirectoryInitializer } from '../features/data_directory/cli_data_directory_initializer.js';
 import { ExecutionContextInitializer } from '../features/execution_context/execution_context_initalizer.js';
@@ -13,6 +13,7 @@ import { getThemeInitializersForCommand } from '../../theme/index.js';
 import { CLI_AUTH_TOPIC_NAME, CLI_COMMANDS_NAMES } from '../commands/commands_constants.js';
 import { ThemeActionsInitializer } from '../../theme/features/theme/actions/theme_actions_initializer.js';
 import { ThemesListInitializer } from '../../theme/features/themes/list/themes_list_initializer.js';
+import { LoggerInitializer } from '../utilities/features/logger/logger_initializer.js';
 tmp.setGracefulCleanup();
 export const cliSetup = async () => {
     //TODO jakis ładny komuniakt błedu
@@ -24,6 +25,8 @@ export const cliSetup = async () => {
             HTTPRequesterInitializer,
             CliDataDirectoryInitializer,
             ExecutionContextInitializer,
+            CliVersionInitializer,
+            LoggerInitializer,
             CliAuthTokensInitializer,
             CliAuthInitializer,
             ...getCommandBaseInitializers()
@@ -35,10 +38,9 @@ export const cliSetup = async () => {
     });
 };
 const getCommandBaseInitializers = () => {
-    // console.log('process.argv', process.argv);
     if (isCommandsTopic(process.argv[2]))
         return getCommandWithTopicBaseInitializers();
-    return getCommandWithoutTopicBaseInitializers();
+    return [];
 };
 const isCommandsTopic = (arg) => {
     return arg === THEME_TOPIC_NAME || arg === CLI_AUTH_TOPIC_NAME;
@@ -61,13 +63,3 @@ const getCommandWithTopicBaseInitializers = () => {
     }
     return [];
 };
-const getCommandWithoutTopicBaseInitializers = () => {
-    const command = process.argv[2];
-    switch (command) {
-        case CLI_COMMANDS_NAMES.version:
-        case CLI_COMMANDS_NAMES.update: {
-            return [CliVersionInitializer];
-        }
-    }
-    return [];
-};

package/build/cli/features/execution_context/execution_context_service.js

@@ -11,6 +11,7 @@ export class ExecutionContextService {
     }
     async _getGlobalExecutionContext() {
         return {
+            command: process.argv,
             type: EXECUTION_CONTEXTS.global
         };
     }
@@ -26,6 +27,7 @@ export class ExecutionContextService {
             throw 'Theme root directory not found';
         const themeMetaData = await ThemeMetaDataUtils.getThemeMetadata(themeRoot);
         return {
+            command: process.argv,
             type: EXECUTION_CONTEXTS.theme,
             themeId: themeMetaData.themeId,
             executionDir: process.cwd(),

package/build/cli/features/version/service/cli_version_service.js

@@ -11,14 +11,14 @@ export class CliVersionService {
         });
     }
     getGloballyInstalledVersion() {
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             exec(`npm list -g ${CLI_NAME} --depth=0 --json`, (_, stdout) => {
                 try {
                     const versionInfo = JSON.parse(stdout);
                     resolve(versionInfo.dependencies?.[CLI_NAME]?.version);
                 }
                 catch {
-                    resolve(undefined);
+                    reject('Failed to parse version information');
                 }
             });
         });

package/build/cli/hooks/authorization/ensure_authorization_hook.js

@@ -1,16 +1,23 @@
 import { COMMANDS_THAT_REQUIRE_AUTHORIZATION } from './ensure_authorization_hook_constants.js';
-import { useApi } from '../ensure_cli_initialized_hook.js';
 import { CLI_AUTH_API_NAME } from '../../auth/cli_auth_constants.js';
 import { CLI_AUTH_TOKENS_API_NAME } from '../../auth/tokens/cli_auth_tokens_constants.js';
 import { promptForToken } from '../../commands/utils/prompt_for_token_utils.js';
 import { CliAuthUtils } from '../../auth/cli_auth_utils.js';
+import { LOGGER_API_NAME } from '../../utilities/features/logger/logger_constants.js';
+import { useApi } from '../../../utils/use_api.js';
 const ensureAuthorizationHook = async ({ Command }) => {
-    if (!COMMANDS_THAT_REQUIRE_AUTHORIZATION.includes(Command.id))
+    const loggerApi = useApi(LOGGER_API_NAME);
+    if (!COMMANDS_THAT_REQUIRE_AUTHORIZATION.includes(Command.id)) {
+        loggerApi.debug('Skipping authorization check for command.', { details: { commandId: Command.id } });
         return;
+    }
+    loggerApi.info('Ensuring user is authorized for command.', { details: { commandId: Command.id } });
     const cliAuthApi = useApi(CLI_AUTH_API_NAME);
     const cliAuthTokensApi = useApi(CLI_AUTH_TOKENS_API_NAME);
     while (!CliAuthUtils.checkCredentials(cliAuthApi, Command)) {
+        loggerApi.info('User is not authorized. Prompting for token.');
         await promptForToken(cliAuthTokensApi);
     }
+    loggerApi.info('User is authorized.');
 };
 export default ensureAuthorizationHook;

package/build/cli/hooks/ensure_cli_initialized_hook.js

@@ -1,10 +1,5 @@
-import { API_RESOLVER_QUERIES, getStarCoreEnvironment, QueryMessage } from '@dreamcommerce/star_core';
 import { CLI_DATA_DIRECTORY_API_NAME } from '../features/data_directory/cli_data_directory_constants.js'; //TODO move to star_core
-//TODO move to star_core
-export function useApi(apiName) {
-    const { queryBus } = getStarCoreEnvironment();
-    return queryBus.executeSync(new QueryMessage(API_RESOLVER_QUERIES.getApiSync, apiName));
-}
+import { useApi } from '../../utils/use_api.js';
 const ensureCliInitializedHook = async () => {
     const projectApi = useApi(CLI_DATA_DIRECTORY_API_NAME);
     await projectApi.ensureDataDirectory();

package/build/cli/hooks/ensure_logs_flushed_hook.js

@@ -0,0 +1,7 @@
+import { LOGGER_API_NAME } from '../utilities/features/logger/logger_constants.js';
+import { useApi } from '../../utils/use_api.js';
+const ensureLogsFlushed = async () => {
+    const loggerApi = useApi(LOGGER_API_NAME);
+    await loggerApi.flush();
+};
+export default ensureLogsFlushed;

package/build/cli/{features → utilities/features}/http_requester/http_client.js

@@ -1,7 +1,7 @@
 import axios from 'axios';
 import { FeatureCore } from '@dreamcommerce/star_core';
-import { CLI_AUTH_API_NAME } from '../../auth/cli_auth_constants.js';
-import { CLI_AUTH_TOKENS_API_NAME } from '../../auth/tokens/cli_auth_tokens_constants.js';
+import { CLI_AUTH_API_NAME } from '../../../auth/cli_auth_constants.js';
+import { CLI_AUTH_TOKENS_API_NAME } from '../../../auth/tokens/cli_auth_tokens_constants.js';
 export class HttpClient extends FeatureCore {
     #axios;
     constructor() {

package/build/cli/{features → utilities/features}/http_requester/http_requester_initializer.js

@@ -1,6 +1,6 @@
 import { CACHE_TYPES, CacheService, DEFAULT_REQUESTER_CACHE_NAMESPACE, FEATURE_CORES_TYPES, HTTP_REQUESTER_FEATURE_NAME, HTTPRequesterApi, HTTPRequesterBalancer, REQUEST_SOURCE, Requester, RequesterCacheServiceKeySerializer, SANITIZER_API_NAME, StrategiesContainer, SyncFeatureInitializer } from '@dreamcommerce/star_core';
 import { HttpClient } from './http_client.js';
-import { CacheFactory } from '../../class/caches/cache_factory.js';
+import { CacheFactory } from '../../../class/caches/cache_factory.js';
 export class HTTPRequesterInitializer extends SyncFeatureInitializer {
     static featureName = HTTP_REQUESTER_FEATURE_NAME;
     init() {

package/build/cli/utilities/features/logger/api/logger_api.js

@@ -0,0 +1,28 @@
+import { FeatureApi } from '@dreamcommerce/star_core';
+import { LOGGER_API_NAME } from '../logger_constants.js';
+export class LoggerApi extends FeatureApi {
+    moduleName = LOGGER_API_NAME;
+    #service;
+    constructor(loggerService) {
+        super();
+        this.#service = loggerService;
+    }
+    debug(message, props) {
+        this.#service.debug(message, props);
+    }
+    info(message, props) {
+        this.#service.info(message, props);
+    }
+    warn(message, props) {
+        this.#service.warn(message, props);
+    }
+    error(message, props) {
+        this.#service.error(message, props);
+    }
+    fatal(message, props) {
+        this.#service.fatal(message, props);
+    }
+    async flush() {
+        await this.#service.flush();
+    }
+}

package/build/cli/utilities/features/logger/logger_constants.js

@@ -0,0 +1,7 @@
+export const LOGGER_FEATURE_NAME = 'LoggerFeature';
+export const LOGGER_API_NAME = 'LoggerApi';
+export const LOGGER_DEBUG_MODES = {
+    none: 'none',
+    standard: 'standard',
+    detailed: 'detailed'
+};