zcatalyst-cli 1.26.2 → 1.27.0

package/lib/pull/features/client.js

@@ -1,4 +1,37 @@
 'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -17,51 +50,101 @@ const archiver_1 = __importDefault(require("../../archiver"));
 const client_utils_1 = require("../../client-utils");
 const endpoints_1 = require("../../endpoints");
 const error_1 = __importDefault(require("../../error"));
-const prompt_1 = __importDefault(require("../../prompt"));
+const prompt_1 = __importStar(require("../../prompt"));
 const runtime_store_1 = __importDefault(require("../../runtime-store"));
 const config_1 = require("../../util_modules/config");
 const fs_1 = require("../../util_modules/fs");
 const js_1 = require("../../util_modules/js");
 const index_1 = require("../../util_modules/logger/index");
 const path_1 = require("path");
+const env_1 = require("../../util_modules/env");
+const option_1 = require("../../util_modules/option");
+const utils_1 = require("../utils");
+function getPullClientVersion() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const webappAPI = yield (0, endpoints_1.clientAPI)();
+        const historyArr = (yield webappAPI.getAllHistory());
+        if (historyArr.length === 0) {
+            (0, index_1.warning)('No Web Client app version found, Ensure that a Web Client is deployed in catalyst console before pulling it.');
+            return;
+        }
+        const resource = (0, option_1.getOptionValue)(utils_1.promptPullFields.get('resource').optKey, undefined);
+        if (resource) {
+            const resources = resource.split(',');
+            if (resources.length > 1) {
+                throw new error_1.default('Multiple resources are not allowed for client pull. Please specify only one client version to pull.', {
+                    exit: 1,
+                    errorId: 'E_NON_INTERACTIVE_CLIENT_PULL_MULTIPLE_RESOURCES',
+                    arg: [(0, ansi_colors_1.italic)('catalyst pull client --resource <client_version>')]
+                });
+            }
+            const _appVersion = historyArr.find((history) => history.app_version === resources[0]);
+            return _appVersion ? _appVersion.history_id : undefined;
+        }
+        else if ((0, env_1.isNonInteractiveMode)()) {
+            throw new error_1.default('Client pull failed. Please specify the client version to pull using --resource option in non-interactive mode.', {
+                exit: 1,
+                errorId: 'E_NON_INTERACTIVE_CLIENT_PULL_NO_RESOURCE',
+                arg: [
+                    (0, ansi_colors_1.italic)('--resource'),
+                    (0, ansi_colors_1.italic)(`catalyst pull client ${(0, ansi_colors_1.green)('--resource <client_version>')}`),
+                    (0, ansi_colors_1.bold)(historyArr.map((history) => '* ' + history.app_version).join('\n'))
+                ]
+            });
+        }
+        const choices = historyArr.map((history) => {
+            let live = '';
+            if (js_1.JS.get(history, 'status', false)) {
+                live = (0, ansi_colors_1.cyan)(' (LIVE)');
+            }
+            return prompt_1.default.choice(history.app_version + live, {
+                value: history.history_id,
+                short: history.app_version,
+                id: history.app_version
+            });
+        });
+        const historyAns = yield prompt_1.default.ask(prompt_1.default.question('history', 'Select a Catalyst client app version : ', {
+            type: 'list',
+            choices
+        }));
+        return historyAns.history;
+    });
+}
 exports.default = () => __awaiter(void 0, void 0, void 0, function* () {
     const clientDirName = config_1.clientConfig.source();
     const clientDirPath = clientDirName;
     const webappAPI = yield (0, endpoints_1.clientAPI)();
-    const historyArr = (yield webappAPI.getAllHistory());
-    if (historyArr.length === 0) {
-        (0, index_1.info)('No history details found in remote console');
+    const historyAns = yield getPullClientVersion();
+    if (!historyAns)
         return;
-    }
     const folderExits = yield fs_1.ASYNC.dirExists(clientDirPath);
     const overwriteAns = folderExits
-        ? yield prompt_1.default.ask(prompt_1.default.question('overwrite', 'Directory ' + (0, ansi_colors_1.underline)(clientDirName) + ' already exists. Overwrite ?', {
-            type: 'confirm',
-            defaultAns: false
+        ? yield prompt_1.default.ask((0, prompt_1.overwritePromptQuestion)({
+            resourceName: clientDirName,
+            defaultAns: (0, env_1.isNonInteractiveMode)() &&
+                (0, option_1.getOptionValue)(utils_1.promptPullFields.get('overwrite').optKey, false)
+                ? true
+                : false
         }))
         : { overwrite: true };
     if (!overwriteAns.overwrite) {
+        if ((0, env_1.isNonInteractiveMode)()) {
+            throw new error_1.default('Client pull failed as the client directory already exists and the --overwrite option is not used to overwrite the file in local', {
+                exit: 1,
+                errorId: 'E_NON_INTERACTIVE_CLIENT_PULL_NO_OVERWRITE',
+                arg: [
+                    ansi_colors_1.italic.red(clientDirPath),
+                    (0, ansi_colors_1.italic)('--overwrite'),
+                    (0, ansi_colors_1.italic)(`catalyst pull client ${(0, ansi_colors_1.green)('--overwrite')}`)
+                ]
+            });
+        }
         (0, index_1.info)('Skipping client pull');
         return;
     }
     yield fs_1.ASYNC.deleteDir(clientDirPath).catch();
-    const choices = historyArr.map((history) => {
-        let live = '';
-        if (js_1.JS.get(history, 'status', false)) {
-            live = (0, ansi_colors_1.cyan)(' (LIVE)');
-        }
-        return prompt_1.default.choice(history.app_version + live, {
-            value: history.history_id,
-            short: history.app_version,
-            id: history.app_version
-        });
-    });
-    const historyAns = yield prompt_1.default.ask(prompt_1.default.question('history', 'Select a Catalyst client app version : ', {
-        type: 'list',
-        choices
-    }));
     try {
-        const clientZip = (yield webappAPI.download(historyAns.history));
+        const clientZip = (yield webappAPI.download(historyAns));
         yield new archiver_1.default().load(clientZip).extract(clientDirPath).finalize();
         yield client_utils_1.clientUtils.validate({ skipPluginValidation: true });
     }

package/lib/pull/features/functions/index.js

@@ -1,4 +1,37 @@
 'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -17,7 +50,7 @@ const path_1 = require("path");
 const languages_1 = require("./languages");
 const archiver_1 = __importDefault(require("../../../archiver"));
 const endpoints_1 = require("../../../endpoints");
-const prompt_1 = __importDefault(require("../../../prompt"));
+const prompt_1 = __importStar(require("../../../prompt"));
 const runtime_store_1 = __importDefault(require("../../../runtime-store"));
 const config_1 = require("../../../util_modules/config");
 const constants_1 = require("../../../util_modules/constants");
@@ -30,8 +63,12 @@ const python_1 = require("../../../fn-utils/lib/python");
 const throbber_1 = __importDefault(require("../../../throbber"));
 const ensure_java_userconfig_1 = require("../../../fn-utils/lib/java/ensure-java-userconfig");
 const logger_1 = require("../../../util_modules/logger");
+const env_1 = require("../../../util_modules/env");
+const utils_1 = require("../../utils");
+const option_1 = require("../../../util_modules/option");
 function selFnsPrompt(targs, fnDirPath) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
         const choicesObj = targs.reduce((accumulator, fn) => {
             const name = fn.name;
             const type = fn.type === constants_1.REMOTE_REF.functions.type[constants_1.FN_TYPE.applogic]
@@ -58,6 +95,49 @@ function selFnsPrompt(targs, fnDirPath) {
             result.push(...value);
             return result;
         }, []);
+        if ((0, env_1.isNonInteractiveMode)()) {
+            const fns = ((_a = ((0, option_1.getOptionValue)(utils_1.promptPullFields.get('resource').optKey, undefined) ||
+                undefined)) === null || _a === void 0 ? void 0 : _a.split(',')) || [];
+            if (fns.length === 0) {
+                throw new error_1.default('Fns to pull not specified in non-interactive mode', {
+                    exit: 1,
+                    errorId: 'E_NON_INTERACTIVE_FNS_PULL-1',
+                    arg: [
+                        (0, ansi_colors_1.italic)('--resource'),
+                        (0, ansi_colors_1.italic)('catalyst pull functions --resource fn1,fn2,fn3'),
+                        (0, ansi_colors_1.bold)(choicesArr
+                            .filter((_choice) => { var _a; return !!_choice.id || !!((_a = _choice.value) === null || _a === void 0 ? void 0 : _a.name); })
+                            .map((choice) => '* ' + (choice.id || choice.value.name))
+                            .join('\n'))
+                    ]
+                });
+            }
+            return fns.reduce((_fnsArr, _fn) => {
+                const _choice = choicesArr.find((_choice) => {
+                    var _a;
+                    return (_choice.id && _choice.id === _fn) ||
+                        (((_a = _choice.value) === null || _a === void 0 ? void 0 : _a.name) && _choice.value.name === _fn);
+                });
+                if (_choice) {
+                    _fnsArr.push(_choice.value);
+                }
+                else {
+                    throw new error_1.default('Cannot find the function in remote: ' + _fn, {
+                        exit: 1,
+                        errorId: 'E_NON_INTERACTIVE_FNS_PULL-2',
+                        arg: [
+                            (0, ansi_colors_1.italic)(`--resource ${(0, ansi_colors_1.red)(_fn)}`),
+                            (0, ansi_colors_1.italic)('--resource'),
+                            (0, ansi_colors_1.bold)(choicesArr
+                                .filter((_choice) => { var _a; return !!_choice.id || !!((_a = _choice.value) === null || _a === void 0 ? void 0 : _a.name); })
+                                .map((choice) => '* ' + (choice.id || choice.value.name))
+                                .join('\n'))
+                        ]
+                    });
+                }
+                return _fnsArr;
+            }, []);
+        }
         const functionsAns = yield prompt_1.default.ask(prompt_1.default.question('functions', 'Select all the functions that you want to pull from remote console : ', {
             type: 'checkbox',
             choices: choicesArr,
@@ -108,15 +188,31 @@ exports.default = (_fns) => __awaiter(void 0, void 0, void 0, function* () {
     yield Promise.all(fns.map((fn) => __awaiter(void 0, void 0, void 0, function* () {
         const folderExists = yield fs_1.ASYNC.dirExists(fn.source);
         if (folderExists) {
-            dirOverwriteQns.push(prompt_1.default.question(fn.name, 'Directory ' + (0, ansi_colors_1.underline)(fn.source) + ' already exists. Overwrite ?', {
-                type: 'confirm',
-                defaultAns: false
+            dirOverwriteQns.push((0, prompt_1.overwritePromptQuestion)({
+                fieldOrName: fn.name,
+                resourceName: fn.source,
+                defaultAns: (0, env_1.isNonInteractiveMode)() ? true : false
             }));
         }
     })));
     const dirOverwriteAns = yield prompt_1.default.ask(...dirOverwriteQns);
     const targets = fns.filter((fn) => {
         if (dirOverwriteAns[fn.name] === undefined || dirOverwriteAns[fn.name]) {
+            if ((0, env_1.isNonInteractiveMode)()) {
+                const overWriteOpt = (0, option_1.getOptionValue)(utils_1.promptPullFields.get('overwrite').optKey, false);
+                if (!overWriteOpt) {
+                    throw new error_1.default('Cannot overwrite existing function directory in non-interactive mode as the --overwrite option is not specified', {
+                        exit: 1,
+                        errorId: 'E_NON_INTERACTIVE_FNS_PULL-3',
+                        arg: [
+                            (0, ansi_colors_1.bold)(`(${fn.name})`),
+                            (0, ansi_colors_1.italic)('catalyst pull'),
+                            (0, ansi_colors_1.italic)('--overwrite'),
+                            (0, ansi_colors_1.italic)(`catalyst pull functions --resource ${(0, option_1.getOptionValue)(utils_1.promptPullFields.get('resource').optKey, 'fn1,fn2,fn3')} ${(0, ansi_colors_1.bold)('--overwrite')}`)
+                        ]
+                    });
+                }
+            }
             return true;
         }
         (0, index_1.message)('skipping pull of function: ' + fn.name);

package/lib/pull/index.js

@@ -41,7 +41,7 @@ function pull() {
         (0, index_1.info)((0, ansi_colors_1.bold)('\n' + (0, ansi_colors_1.white)('===> ') + js_1.JS.capitalize(feature) + ' Setup'));
         yield MODULE().catch((err) => {
             (0, index_1.info)();
-            (0, index_1.warning)(`Skipping pull of ${feature}. Since ${err.message}.\nContact Catalyst Support with catalyst-debug.log file.`);
+            (0, index_1.warning)(`Skipping pull of ${feature}. Since ${err.message}.`);
         });
         if (runtime_store_1.default.get('context.payload.' + feature, false)) {
             runtime_store_1.default.set('context.payload.features', runtime_store_1.default.get('context.payload.features', []).concat(feature));

package/lib/pull/utils.d.ts

@@ -0,0 +1,13 @@
+export declare const promptPullFields: import("../prompt").PromptFieldsRegistry<readonly [{
+    readonly name: "overwrite";
+    readonly cliOption: {
+        readonly option: "--overwrite";
+        readonly description: "Overwrite existing resources such as functions/client/apig in the local directory if present";
+    };
+}, {
+    readonly name: "resource";
+    readonly cliOption: {
+        readonly option: "--resource <fn_name|client_version>";
+        readonly description: "Specify the name of the resource to pull as comma separated values. For example: --resource func1,func2 (only applicable for Non-Interactive mode)";
+    };
+}]>;

package/lib/pull/utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptPullFields = void 0;
+const prompt_1 = require("../prompt");
+exports.promptPullFields = (0, prompt_1.definePromptFields)([
+    {
+        name: 'overwrite',
+        cliOption: {
+            option: '--overwrite',
+            description: 'Overwrite existing resources such as functions/client/apig in the local directory if present'
+        }
+    },
+    {
+        name: 'resource',
+        cliOption: {
+            option: '--resource <fn_name|client_version>',
+            description: 'Specify the name of the resource to pull as comma separated values. For example: --resource func1,func2 (only applicable for Non-Interactive mode)'
+        }
+    }
+]);

package/lib/repl-server.d.ts

@@ -21,6 +21,10 @@ declare class Repl {
     start(): Repl;
     emit(eventName: string, ...inputs: Array<any>): boolean;
     showPrompt(): void;
+    defineCommand(keyword: string, cmd: {
+        help?: string;
+        action: (this: REPLServer, args: string) => void;
+    }): Repl;
     setContext(command: string, exe: unknown): Repl;
     close(): void;
     pause(): void;

package/lib/repl-server.js

@@ -58,6 +58,15 @@ class Repl {
             this.server.displayPrompt();
         }
     }
+    defineCommand(keyword, cmd) {
+        if (this.server === null) {
+            throw new index_js_1.default('command cannot be defined before server is started', {
+                exit: 2
+            });
+        }
+        this.server.defineCommand(keyword, cmd);
+        return this;
+    }
     setContext(command, exe) {
         if (this.server === null) {
             throw new index_js_1.default('context cannot be set before server is started', { exit: 2 });

package/lib/serve/server/lib/master/index.js

@@ -29,7 +29,7 @@ const js_1 = require("../../../../util_modules/js");
 const index_1 = require("../../../../util_modules/logger/index");
 const project_2 = require("../../../../util_modules/project");
 const option_1 = require("../../../../util_modules/option");
-const server_js_1 = require("../../../../util_modules/server.js");
+const index_js_1 = require("../../../../util_modules/server/index.js");
 const utils_1 = require("./utils");
 const appsail_1 = require("./appsail");
 const web_client_1 = require("./web-client");
@@ -104,7 +104,7 @@ function spinUpMaster(listenPort_1, _a) {
                 signInRedirect: appSailDetails.target.config.login_redirect || '/'
             }))
             : proxy.on('proxyRes', (0, utils_1.proxyResponseHandler)({ systemRoutes, signInRedirect: signRedirectUrl }));
-        const proxyDestroyer = new server_js_1.ConnectionDestroyer(proxy);
+        const proxyDestroyer = new index_js_1.ConnectionDestroyer(proxy);
         const unknownProxy = (0, unknown_req_proxy_1.default)(proxy, listenPort, customProxyUrl);
         otherServerDetails &&
             Object.keys(otherServerDetails).forEach((targ) => {
@@ -148,7 +148,7 @@ function spinUpMaster(listenPort_1, _a) {
             }
             console.error(err);
         });
-        const expressDestroyer = new server_js_1.ConnectionDestroyer(expressServer);
+        const expressDestroyer = new index_js_1.ConnectionDestroyer(expressServer);
         expressServer.maxConnections = 100;
         const stopServer = () => expressDestroyer.destroy(!!appSailDetails);
         utils_1.serverEvent.once('stop', () => {

package/lib/serve/server/lib/slate/static-server.js

@@ -24,7 +24,7 @@ const path_1 = require("path");
 const ws_1 = require("ws");
 const port_resolver_js_1 = __importDefault(require("../../../../port-resolver.js"));
 const ansi_colors_1 = require("ansi-colors");
-const server_js_1 = require("../../../../util_modules/server.js");
+const index_js_2 = require("../../../../util_modules/server/index.js");
 const env_1 = require("../../../../util_modules/env");
 function prepareScriptFile(dir, port) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -180,7 +180,7 @@ function slateServer(httpPort_1, source_1) {
         const server = app.listen(httpPort, '127.0.0.1').on('error', (err) => {
             eventListener.emit('error', err);
         });
-        const expressDestroyer = new server_js_1.ConnectionDestroyer(server);
+        const expressDestroyer = new index_js_2.ConnectionDestroyer(server);
         eventListener.on('error', (err) => {
             (0, logger_1.error)('Error when serving the web-client: ' + err.message);
             (0, logger_1.info)('Please exit the command to get more info');

package/lib/serve/server/lib/web_client/server.js

@@ -24,7 +24,7 @@ const path_1 = require("path");
 const ws_1 = require("ws");
 const port_resolver_js_1 = __importDefault(require("../../../../port-resolver.js"));
 const ansi_colors_1 = require("ansi-colors");
-const server_js_1 = require("../../../../util_modules/server.js");
+const index_js_4 = require("../../../../util_modules/server/index.js");
 const env_1 = require("../../../../util_modules/env");
 function prepareScriptFile(dir, port) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -180,7 +180,7 @@ function webClientServer(httpPort_1, source_1) {
         const server = app.listen(httpPort, '127.0.0.1').on('error', (err) => {
             eventListener.emit('error', err);
         });
-        const expressDestroyer = new server_js_1.ConnectionDestroyer(server);
+        const expressDestroyer = new index_js_4.ConnectionDestroyer(server);
         eventListener.on('error', (err) => {
             (0, index_1.error)('Error when serving the web-client: ' + err.message);
             (0, index_1.info)('Please exit the command to get more info');

package/lib/shell/format-functions.d.ts

@@ -0,0 +1,4 @@
+import { IFnTarget } from '../fn-utils/lib/common';
+export declare function resolveTypeLabel(type?: string): string;
+export declare function resolveLanguage(stack?: string): string | undefined;
+export declare function formatFunctionList(targets: Array<IFnTarget>): string;

package/lib/shell/format-functions.js

@@ -0,0 +1,59 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTypeLabel = resolveTypeLabel;
+exports.resolveLanguage = resolveLanguage;
+exports.formatFunctionList = formatFunctionList;
+const ansi_colors_1 = require("ansi-colors");
+const constants_1 = require("../util_modules/constants");
+const UNGROUPED_TYPE = 'other';
+const TYPE_LABEL_BY_CODE = Object.fromEntries(Object.entries(constants_1.FN_TYPE).map(([label, code]) => [code, label]));
+function resolveTypeLabel(type) {
+    if (!type) {
+        return UNGROUPED_TYPE;
+    }
+    return TYPE_LABEL_BY_CODE[type] || type;
+}
+function resolveLanguage(stack) {
+    if (!stack) {
+        return undefined;
+    }
+    const { node, java, python } = constants_1.RUNTIME.language;
+    if (stack.startsWith(node.value)) {
+        return node.label;
+    }
+    if (stack.startsWith(java.value)) {
+        return java.label;
+    }
+    if (stack.startsWith(python.value)) {
+        return python.label;
+    }
+    return undefined;
+}
+function formatFunctionList(targets) {
+    if (!targets || targets.length === 0) {
+        return 'No functions are attached to this shell.';
+    }
+    const groups = new Map();
+    for (const target of targets) {
+        const type = resolveTypeLabel(target.type);
+        const bucket = groups.get(type) || [];
+        bucket.push(target);
+        groups.set(type, bucket);
+    }
+    const longestName = targets.reduce((max, target) => Math.max(max, target.name.length), 0);
+    const lines = [];
+    lines.push((0, ansi_colors_1.bold)(`Available functions (${targets.length}):`));
+    lines.push('');
+    for (const [type, bucket] of groups) {
+        lines.push('  ' + (0, ansi_colors_1.cyan)(type));
+        for (const target of bucket) {
+            const language = resolveLanguage(target.stack);
+            const name = (0, ansi_colors_1.green)(target.name.padEnd(longestName));
+            const suffix = language ? '  ' + (0, ansi_colors_1.dim)(`(${language})`) : '';
+            lines.push('    • ' + name + suffix);
+        }
+    }
+    lines.push('');
+    lines.push((0, ansi_colors_1.dim)('Invoke a function by calling it, e.g. ') + (0, ansi_colors_1.bold)(targets[0].name + '({ ... })'));
+    return lines.join('\n');
+}

package/lib/shell/index.js

@@ -59,6 +59,7 @@ const option_1 = require("../util_modules/option");
 const http_functions_1 = __importDefault(require("./dependencies/http-functions"));
 const non_http_function_1 = __importDefault(require("./dependencies/non-http-function"));
 const prepare_1 = __importDefault(require("./prepare"));
+const format_functions_1 = require("./format-functions");
 const fn_watcher_1 = __importDefault(require("../fn-watcher"));
 const tunnel_server_1 = __importDefault(require("./dependencies/tunnel-server"));
 const endpoints_1 = require("../endpoints");
@@ -125,6 +126,9 @@ exports.default = () => __awaiter(void 0, void 0, void 0, function* () {
         });
     }
     try {
+        (0, index_2.info)();
+        (0, index_2.info)((0, format_functions_1.formatFunctionList)(targets));
+        (0, index_2.info)();
         replServer.start();
         yield tunnelServer.startServer();
         const tunnelUrl = runtime_store_1.default.get('context.fn_shell.enable_tunnel', undefined);
@@ -167,6 +171,20 @@ exports.default = () => __awaiter(void 0, void 0, void 0, function* () {
             tunnelServer.addContext(target.id || target.name, localFn);
             target.localFn = localFn;
         })));
+        const listFunctions = () => {
+            var _a, _b;
+            (_a = replServer.server) === null || _a === void 0 ? void 0 : _a.clearBufferedCommand();
+            (0, index_2.info)((0, format_functions_1.formatFunctionList)(targets));
+            (_b = replServer.server) === null || _b === void 0 ? void 0 : _b.displayPrompt();
+        };
+        replServer.defineCommand('functions', {
+            help: 'List the Catalyst functions available in this shell',
+            action: listFunctions
+        });
+        replServer.defineCommand('list', {
+            help: 'Alias for .functions — list the Catalyst functions available in this shell',
+            action: listFunctions
+        });
         if (runtime_store_1.default.get('context.port.http.' + constants_1.FN_TYPE.basic, false)) {
             yield httpServer.start();
         }

package/lib/util_modules/config/lib/appsail.d.ts

@@ -4,8 +4,8 @@ export interface IAppSailConfig {
     command?: string;
     memory?: number;
     port?: {
-        http: number;
-        debug: number;
+        http?: number;
+        debug?: number;
     };
 }
 export interface IAppSailServerConfig extends Record<string, unknown> {
@@ -44,6 +44,7 @@ export declare const CONTAINER_IMAGE_PROTOCOLS: {
     docker: string;
     dockerArchive: string;
 };
+export declare function isCustomAppSailSource(source: string): boolean;
 export declare function raw(throwError?: boolean): Array<TAppSailDetails> | undefined;
 export declare function getTargetDetails(name: string): Promise<TAppSailDetails | undefined>;
 export declare function getAllTargetDetails(throwErr?: boolean): Promise<Array<TAppSailDetails> | undefined>;

package/lib/util_modules/config/lib/appsail.js

@@ -13,6 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONTAINER_IMAGE_PROTOCOLS = void 0;
+exports.isCustomAppSailSource = isCustomAppSailSource;
 exports.raw = raw;
 exports.getTargetDetails = getTargetDetails;
 exports.getAllTargetDetails = getAllTargetDetails;
@@ -27,6 +28,10 @@ exports.CONTAINER_IMAGE_PROTOCOLS = {
     docker: 'docker://',
     dockerArchive: 'docker-archive://'
 };
+function isCustomAppSailSource(source) {
+    return (source.startsWith(exports.CONTAINER_IMAGE_PROTOCOLS.docker) ||
+        source.startsWith(exports.CONTAINER_IMAGE_PROTOCOLS.dockerArchive));
+}
 function validateManagedAppConfig(source, configJson) {
     if (!configJson) {
         return {
@@ -105,9 +110,7 @@ function raw(throwError = false) {
         return `${exports.CONTAINER_IMAGE_PROTOCOLS.dockerArchive}${normalized}`;
     };
     return appsailConfig === null || appsailConfig === void 0 ? void 0 : appsailConfig.map((_conf) => {
-        if (Object.values(exports.CONTAINER_IMAGE_PROTOCOLS)
-            .flat()
-            .find((proto) => _conf.source.startsWith(proto))) {
+        if (isCustomAppSailSource(_conf.source)) {
             return {
                 name: _conf.name,
                 source: _conf.source.startsWith(exports.CONTAINER_IMAGE_PROTOCOLS.dockerArchive)

package/lib/util_modules/config/lib/slate.d.ts

@@ -32,6 +32,25 @@ export interface SlateBuildInfo {
     deployment_id: string;
     build_meta: Record<string, unknown>;
 }
+export interface ISlateDeploymentInfo {
+    id: string;
+    app_id: string;
+    name: string;
+    auto_deploy: boolean;
+    created_time: string;
+    modified_time: string;
+    created_by: IAppUpdatedByDetails;
+    modified_by: IAppUpdatedByDetails;
+    status: string;
+    is_function_mapped: boolean;
+    org_restriction_enabled: boolean;
+    type: string;
+    value: string;
+    current_build: SlateBuildInfo | null;
+    upcoming_build: SlateBuildInfo | null;
+    origin_domain: string;
+    domain: string;
+}
 export interface IAppUpdatedByDetails {
     zuid: string;
     is_confirmed: boolean;

package/lib/util_modules/config-store.d.ts

@@ -1,6 +1,7 @@
 export default class Store {
     private static _store;
     static changeStore(store: 'cli' | 'vscode' | 'zcode', path?: string): void;
+    static _lockDownPermissions(): void;
     private static get istore();
     static get path(): string | undefined;
     static get store(): Record<string, unknown>;