@cyberismo/data-handler 0.0.20 → 0.0.22

package/dist/commands/show.js

@@ -10,6 +10,40 @@
   details. You should have received a copy of the GNU Affero General Public
   License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
 // node
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
@@ -18,6 +52,7 @@ import { spawn } from 'node:child_process';
 import { writeFile } from 'node:fs/promises';
 import { MODULE_LIST_FULL_PATH } from './fetch.js';
 import { UserPreferences } from '../utils/user-preferences.js';
+import { read, write } from '../utils/rw-lock.js';
 import ReportMacro from '../macros/report/index.js';
 import TaskQueue from '../macros/task-queue.js';
 import { evaluateMacros } from '../macros/index.js';
@@ -27,407 +62,477 @@ import { buildCardHierarchy, flattenCardArray } from '../utils/card-utils.js';
 /**
  * Show command.
  */
-export class Show {
-    project;
-    fetchCmd;
-    resourceFunctions = {
-        calculations: (from) => this.resourceNames('calculations', from),
-        cardTypes: (from) => this.resourceNames('cardTypes', from),
-        fieldTypes: (from) => this.resourceNames('fieldTypes', from),
-        graphModels: (from) => this.resourceNames('graphModels', from),
-        graphViews: (from) => this.resourceNames('graphViews', from),
-        linkTypes: (from) => this.resourceNames('linkTypes', from),
-        reports: (from) => this.resourceNames('reports', from),
-        templates: (from) => this.resourceNames('templates', from),
-        workflows: (from) => this.resourceNames('workflows', from),
-    };
-    constructor(project, fetchCmd) {
-        this.project = project;
-        this.fetchCmd = fetchCmd;
-    }
-    get logger() {
-        return getChildLogger({
-            module: 'show',
-        });
-    }
-    // Gets all template attachments
-    async attachmentsFromTemplates() {
-        const templateAttachments = [];
-        const templates = this.project.resources.templates();
-        for (const template of templates) {
-            const templateObject = template.templateObject();
-            if (templateObject) {
-                templateAttachments.push(...templateObject.attachments());
-            }
-        }
-        return templateAttachments;
-    }
-    // Fetch resource names as a list
-    resourceNames(resourceType, from) {
-        return this.project.resources
-            .resourceTypes(resourceType, from)
-            .map((item) => item.data?.name || '');
-    }
-    // Collect all labels from cards.
-    collectLabels = (cards) => {
-        return cards.reduce((labels, card) => {
-            // Add the labels from the current card
-            if (card.metadata?.labels) {
-                labels.push(...card.metadata.labels);
-            }
-            return labels;
-        }, []);
-    };
-    // Returns attachment details
-    getAttachment(cardKey, filename) {
-        const card = this.project.findCard(cardKey);
-        const attachment = card.attachments?.find((a) => a.fileName === filename) ?? undefined;
-        return attachment;
-    }
-    // Opens the given path using the operating system's default application. Doesn't block the main thread.
-    // @todo: Move away from Show.
-    openUsingDefaultApplication(path) {
-        if (process.platform === 'win32') {
-            // This is a workaround to get windows to open the file in foreground
-            spawn(`start`, ['cmd.exe', '/c', 'start', '""', `"${path}"`], {
-                shell: true,
-            });
-        }
-        else if (process.platform === 'darwin') {
-            spawn('open', [path]);
+let Show = (() => {
+    let _instanceExtraInitializers = [];
+    let _showAllTemplateCards_decorators;
+    let _showAttachments_decorators;
+    let _showAttachment_decorators;
+    let _openAttachment_decorators;
+    let _showCardDetails_decorators;
+    let _showCards_decorators;
+    let _showCardLogicProgram_decorators;
+    let _showCardTypesWithDetails_decorators;
+    let _showImportableModules_decorators;
+    let _showLabels_decorators;
+    let _showLogicProgram_decorators;
+    let _showModule_decorators;
+    let _showHubs_decorators;
+    let _showProjectCards_decorators;
+    let _showModules_decorators;
+    let _showProject_decorators;
+    let _showReportResults_decorators;
+    let _showResources_decorators;
+    let _showTemplatesWithDetails_decorators;
+    let _showWorkflowsWithDetails_decorators;
+    return class Show {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _showAllTemplateCards_decorators = [read];
+            _showAttachments_decorators = [read];
+            _showAttachment_decorators = [read];
+            _openAttachment_decorators = [read];
+            _showCardDetails_decorators = [read];
+            _showCards_decorators = [read];
+            _showCardLogicProgram_decorators = [read];
+            _showCardTypesWithDetails_decorators = [read];
+            _showImportableModules_decorators = [write()];
+            _showLabels_decorators = [read];
+            _showLogicProgram_decorators = [read];
+            _showModule_decorators = [read];
+            _showHubs_decorators = [write()];
+            _showProjectCards_decorators = [read];
+            _showModules_decorators = [read];
+            _showProject_decorators = [read];
+            _showReportResults_decorators = [read];
+            _showResources_decorators = [read];
+            _showTemplatesWithDetails_decorators = [read];
+            _showWorkflowsWithDetails_decorators = [read];
+            __esDecorate(this, null, _showAllTemplateCards_decorators, { kind: "method", name: "showAllTemplateCards", static: false, private: false, access: { has: obj => "showAllTemplateCards" in obj, get: obj => obj.showAllTemplateCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showAttachments_decorators, { kind: "method", name: "showAttachments", static: false, private: false, access: { has: obj => "showAttachments" in obj, get: obj => obj.showAttachments }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showAttachment_decorators, { kind: "method", name: "showAttachment", static: false, private: false, access: { has: obj => "showAttachment" in obj, get: obj => obj.showAttachment }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _openAttachment_decorators, { kind: "method", name: "openAttachment", static: false, private: false, access: { has: obj => "openAttachment" in obj, get: obj => obj.openAttachment }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showCardDetails_decorators, { kind: "method", name: "showCardDetails", static: false, private: false, access: { has: obj => "showCardDetails" in obj, get: obj => obj.showCardDetails }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showCards_decorators, { kind: "method", name: "showCards", static: false, private: false, access: { has: obj => "showCards" in obj, get: obj => obj.showCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showCardLogicProgram_decorators, { kind: "method", name: "showCardLogicProgram", static: false, private: false, access: { has: obj => "showCardLogicProgram" in obj, get: obj => obj.showCardLogicProgram }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showCardTypesWithDetails_decorators, { kind: "method", name: "showCardTypesWithDetails", static: false, private: false, access: { has: obj => "showCardTypesWithDetails" in obj, get: obj => obj.showCardTypesWithDetails }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showImportableModules_decorators, { kind: "method", name: "showImportableModules", static: false, private: false, access: { has: obj => "showImportableModules" in obj, get: obj => obj.showImportableModules }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showLabels_decorators, { kind: "method", name: "showLabels", static: false, private: false, access: { has: obj => "showLabels" in obj, get: obj => obj.showLabels }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showLogicProgram_decorators, { kind: "method", name: "showLogicProgram", static: false, private: false, access: { has: obj => "showLogicProgram" in obj, get: obj => obj.showLogicProgram }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showModule_decorators, { kind: "method", name: "showModule", static: false, private: false, access: { has: obj => "showModule" in obj, get: obj => obj.showModule }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showHubs_decorators, { kind: "method", name: "showHubs", static: false, private: false, access: { has: obj => "showHubs" in obj, get: obj => obj.showHubs }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showProjectCards_decorators, { kind: "method", name: "showProjectCards", static: false, private: false, access: { has: obj => "showProjectCards" in obj, get: obj => obj.showProjectCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showModules_decorators, { kind: "method", name: "showModules", static: false, private: false, access: { has: obj => "showModules" in obj, get: obj => obj.showModules }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showProject_decorators, { kind: "method", name: "showProject", static: false, private: false, access: { has: obj => "showProject" in obj, get: obj => obj.showProject }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showReportResults_decorators, { kind: "method", name: "showReportResults", static: false, private: false, access: { has: obj => "showReportResults" in obj, get: obj => obj.showReportResults }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showResources_decorators, { kind: "method", name: "showResources", static: false, private: false, access: { has: obj => "showResources" in obj, get: obj => obj.showResources }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showTemplatesWithDetails_decorators, { kind: "method", name: "showTemplatesWithDetails", static: false, private: false, access: { has: obj => "showTemplatesWithDetails" in obj, get: obj => obj.showTemplatesWithDetails }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _showWorkflowsWithDetails_decorators, { kind: "method", name: "showWorkflowsWithDetails", static: false, private: false, access: { has: obj => "showWorkflowsWithDetails" in obj, get: obj => obj.showWorkflowsWithDetails }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        else {
-            spawn('xdg-open', [path]);
+        project = __runInitializers(this, _instanceExtraInitializers);
+        fetchCmd;
+        resourceFunctions = {
+            calculations: (from) => this.resourceNames('calculations', from),
+            cardTypes: (from) => this.resourceNames('cardTypes', from),
+            fieldTypes: (from) => this.resourceNames('fieldTypes', from),
+            graphModels: (from) => this.resourceNames('graphModels', from),
+            graphViews: (from) => this.resourceNames('graphViews', from),
+            linkTypes: (from) => this.resourceNames('linkTypes', from),
+            reports: (from) => this.resourceNames('reports', from),
+            templates: (from) => this.resourceNames('templates', from),
+            workflows: (from) => this.resourceNames('workflows', from),
+        };
+        constructor(project, fetchCmd) {
+            this.project = project;
+            this.fetchCmd = fetchCmd;
         }
-    }
-    /**
-     * Shows all template cards in a project.
-     * @returns all template cards in a project.
-     */
-    showAllTemplateCards() {
-        return this.project.resources.templates().map((template) => {
-            const cards = template.templateObject().listCards();
-            const buildCards = buildCardHierarchy(cards);
-            return {
-                name: template.data?.name || '',
-                cards: buildCards,
-            };
-        });
-    }
-    /**
-     * Shows all attachments (either template or project attachments) from a project.
-     * @returns array of card attachments
-     */
-    async showAttachments() {
-        const attachments = this.project.attachments();
-        const templateAttachments = await this.attachmentsFromTemplates();
-        attachments.push(...templateAttachments);
-        return attachments;
-    }
-    /**
-     * Returns file buffer and mime type of an attachment. Used by app UI to download attachments.
-     * @param cardKey card key to find
-     * @param filename attachment filename
-     * @returns attachment details
-     */
-    showAttachment(cardKey, filename) {
-        if (!cardKey) {
-            throw new Error(`Mandatory parameter 'cardKey' missing`);
+        get logger() {
+            return getChildLogger({
+                module: 'show',
+            });
         }
-        const attachment = this.getAttachment(cardKey, filename);
-        if (!attachment) {
-            throw new Error(`Attachment '${filename}' not found for card ${cardKey}`);
+        // Gets all template attachments
+        async attachmentsFromTemplates() {
+            const templateAttachments = [];
+            const templates = this.project.resources.templates();
+            for (const template of templates) {
+                const templateObject = template.templateObject();
+                if (templateObject) {
+                    templateAttachments.push(...templateObject.attachments());
+                }
+            }
+            return templateAttachments;
         }
-        const attachmentPath = `${attachment.path}/${attachment.fileName}`;
-        const fileBuffer = readFileSync(attachmentPath);
-        const mimeType = attachment.mimeType || 'application/octet-stream';
-        const payload = { fileBuffer, mimeType };
-        return payload;
-    }
-    /**
-     * Opens an attachment using a configured application or the operating system's default application.
-     * @param cardKey card key of the attachment
-     * @param filename attachment filename
-     * @param waitDelay amount of time to wait for the application to open the attachment
-     * @todo: Move away from Show.
-     */
-    async openAttachment(cardKey, filename, waitDelay = 1000) {
-        const attachment = this.getAttachment(cardKey, filename);
-        if (!attachment) {
-            throw new Error(`Attachment '${filename}' not found for card ${cardKey}`);
+        // Fetch resource names as a list
+        resourceNames(resourceType, from) {
+            return this.project.resources
+                .resourceTypes(resourceType, from)
+                .map((item) => item.data?.name || '');
         }
-        // Try to open the attachment using a configured application if one exists
-        const prefs = new UserPreferences(join(homedir(), '.cyberismo', 'cards.prefs.json')).getPreferences();
-        const attachmentEditors = prefs.attachmentEditors && process.platform in prefs.attachmentEditors
-            ? prefs.attachmentEditors[process.platform]
-            : [];
-        const editor = attachmentEditors.find((editor) => editor.mimeType === attachment.mimeType);
-        const path = resolve(attachment.path, attachment.fileName);
-        if (!editor) {
-            this.openUsingDefaultApplication(path);
-            return;
+        // Collect all labels from cards.
+        collectLabels = (cards) => {
+            return cards.reduce((labels, card) => {
+                // Add the labels from the current card
+                if (card.metadata?.labels) {
+                    labels.push(...card.metadata.labels);
+                }
+                return labels;
+            }, []);
+        };
+        // Returns attachment details
+        getAttachment(cardKey, filename) {
+            const card = this.project.findCard(cardKey);
+            const attachment = card.attachments?.find((a) => a.fileName === filename) ?? undefined;
+            return attachment;
         }
-        // We can safely assume that the editor command is safe to execute, since it is defined in the preferences file by the user
-        const processHandle = spawn(editor.command.replace('{{attachmentPath}}', path), [], {
-            shell: true,
-        });
-        // wait for the application to open the attachment
-        await new Promise((resolve) => setTimeout(resolve, waitDelay));
-        // If the application exists with a non-zero exit code, open the attachment using the operating system's default application
-        if (processHandle.exitCode !== 0 && processHandle.exitCode !== null) {
-            this.openUsingDefaultApplication(path);
+        // Opens the given path using the operating system's default application. Doesn't block the main thread.
+        // @todo: Move away from Show.
+        openUsingDefaultApplication(path) {
+            if (process.platform === 'win32') {
+                // This is a workaround to get windows to open the file in foreground
+                spawn(`start`, ['cmd.exe', '/c', 'start', '""', `"${path}"`], {
+                    shell: true,
+                });
+            }
+            else if (process.platform === 'darwin') {
+                spawn('open', [path]);
+            }
+            else {
+                spawn('xdg-open', [path]);
+            }
         }
-    }
-    /**
-     * Shows details of a particular card (template card, or project card)
-     * @note Note that parameter 'cardKey' is optional due to technical limitations of class calling this class. It must be defined to get valid results.
-     * @param cardKey card key to find
-     * @param contentType Content format in which content is to be shown
-     * @returns card details
-     */
-    showCardDetails(cardKey, contentType) {
-        if (!cardKey) {
-            throw new Error(`Mandatory parameter 'cardKey' missing`);
+        /**
+         * Shows all template cards in a project.
+         * @returns all template cards in a project.
+         */
+        async showAllTemplateCards() {
+            return this.project.resources.templates().map((template) => {
+                const cards = template.templateObject().listCards();
+                const buildCards = buildCardHierarchy(cards);
+                return {
+                    name: template.data?.name || '',
+                    cards: buildCards,
+                };
+            });
         }
-        // todo: Make a constant about this
-        const details = {
-            parent: true,
-            metadata: true,
-            children: true,
-            attachments: true,
-            content: true,
-        };
-        if (contentType) {
-            details.contentType = contentType;
+        /**
+         * Shows all attachments (either template or project attachments) from a project.
+         * @returns array of card attachments
+         */
+        async showAttachments() {
+            const attachments = this.project.attachments();
+            const templateAttachments = await this.attachmentsFromTemplates();
+            attachments.push(...templateAttachments);
+            return attachments;
         }
-        return this.project.findCard(cardKey, details);
-    }
-    /**
-     * Shows all cards (either template or project cards) from a project.
-     * @param cardsFrom - The location from which to look for cards. Either from the project, templates or both.
-     * @returns cards list array
-     */
-    async showCards(cardsFrom) {
-        return this.project.listCards(cardsFrom);
-    }
-    /**
-     * Shows the content of a logic program.
-     * @param cardKey The key of the card.
-     * @returns the content of the logic program.
-     */
-    async showCardLogicProgram(cardKey) {
-        return this.project.calculationEngine.cardLogicProgram(cardKey);
-    }
-    /**
-     * Shows all card types in a project.
-     * @returns array of card type details
-     */
-    async showCardTypesWithDetails() {
-        const container = [];
-        for (const cardType of this.project.resources.cardTypes()) {
-            if (cardType.data) {
-                container.push(cardType.data);
+        /**
+         * Returns file buffer and mime type of an attachment. Used by app UI to download attachments.
+         * @param cardKey card key to find
+         * @param filename attachment filename
+         * @returns attachment details
+         */
+        async showAttachment(cardKey, filename) {
+            if (!cardKey) {
+                throw new Error(`Mandatory parameter 'cardKey' missing`);
+            }
+            const attachment = this.getAttachment(cardKey, filename);
+            if (!attachment) {
+                throw new Error(`Attachment '${filename}' not found for card ${cardKey}`);
             }
+            const attachmentPath = `${attachment.path}/${attachment.fileName}`;
+            const fileBuffer = readFileSync(attachmentPath);
+            const mimeType = attachment.mimeType || 'application/octet-stream';
+            const payload = { fileBuffer, mimeType };
+            return payload;
         }
-        return container;
-    }
-    /**
-     * Shows importable modules.
-     * @param showAll - When true, shows all importable modules, even if they have already been imported
-     * @param showDetails - When true, shows all properties of modules, not just name.
-     * @returns list of modules; the list content depends on the parameters provided
-     *          by default it is a list of module names that could be imported into the project,
-     *          with 'showDetails' true, instead of name, the list consists of full details of the modules
-     *          with 'showAll' true, the list consists of all modules in the hubs, even if they have already been imported
-     *          Note that the two boolean options can be combined.
-     */
-    async showImportableModules(showAll, showDetails) {
-        try {
-            // Ensure module list is up to date before showing
-            await this.fetchCmd.ensureModuleListUpToDate();
-            const moduleList = (await readJsonFile(resolve(this.project.basePath, MODULE_LIST_FULL_PATH))).modules;
-            const currentModules = this.project.resources.moduleNames();
-            const nonImportedModules = moduleList.filter((item) => {
-                return !currentModules.some((module) => item.name === module);
-            });
-            if (showAll && showDetails) {
-                return moduleList;
+        /**
+         * Opens an attachment using a configured application or the operating system's default application.
+         * @param cardKey card key of the attachment
+         * @param filename attachment filename
+         * @param waitDelay amount of time to wait for the application to open the attachment
+         * @todo: Move away from Show.
+         */
+        async openAttachment(cardKey, filename, waitDelay = 1000) {
+            const attachment = this.getAttachment(cardKey, filename);
+            if (!attachment) {
+                throw new Error(`Attachment '${filename}' not found for card ${cardKey}`);
             }
-            if (showAll) {
-                return moduleList?.map((item) => item?.name);
+            // Try to open the attachment using a configured application if one exists
+            const prefs = new UserPreferences(join(homedir(), '.cyberismo', 'cards.prefs.json')).getPreferences();
+            const attachmentEditors = prefs.attachmentEditors && process.platform in prefs.attachmentEditors
+                ? prefs.attachmentEditors[process.platform]
+                : [];
+            const editor = attachmentEditors.find((editor) => editor.mimeType === attachment.mimeType);
+            const path = resolve(attachment.path, attachment.fileName);
+            if (!editor) {
+                this.openUsingDefaultApplication(path);
+                return;
             }
-            if (showDetails) {
-                return nonImportedModules;
+            // We can safely assume that the editor command is safe to execute, since it is defined in the preferences file by the user
+            const processHandle = spawn(editor.command.replace('{{attachmentPath}}', path), [], {
+                shell: true,
+            });
+            // wait for the application to open the attachment
+            await new Promise((resolve) => setTimeout(resolve, waitDelay));
+            // If the application exists with a non-zero exit code, open the attachment using the operating system's default application
+            if (processHandle.exitCode !== 0 && processHandle.exitCode !== null) {
+                this.openUsingDefaultApplication(path);
             }
-            // By default return the non-imported modules
-            return nonImportedModules.map((item) => item?.name);
         }
-        catch (error) {
-            if (error instanceof Error) {
-                this.logger.error(error.message);
+        /**
+         * Shows details of a particular card (template card, or project card)
+         * @note Note that parameter 'cardKey' is optional due to technical limitations of class calling this class. It must be defined to get valid results.
+         * @param cardKey card key to find
+         * @param contentType Content format in which content is to be shown
+         * @returns card details
+         */
+        async showCardDetails(cardKey, contentType) {
+            if (!cardKey) {
+                throw new Error(`Mandatory parameter 'cardKey' missing`);
             }
-            // Module list doesn't exist, return empty list
-            return [];
+            // todo: Make a constant about this
+            const details = {
+                parent: true,
+                metadata: true,
+                children: true,
+                attachments: true,
+                content: true,
+            };
+            if (contentType) {
+                details.contentType = contentType;
+            }
+            return this.project.findCard(cardKey, details);
         }
-    }
-    /**
-     * Returns all unique labels in a project
-     * @returns labels in a list
-     */
-    showLabels() {
-        const cards = flattenCardArray(this.project.showProjectCards(), this.project);
-        const templateCards = this.project.allTemplateCards();
-        const labels = this.collectLabels([...cards, ...templateCards]);
-        return Array.from(new Set(labels));
-    }
-    /**
-     * Shows the content of a logic program.
-     * @param resource Name of the resource.
-     * @returns the content of the logic program.
-     */
-    async showLogicProgram(resource) {
-        return this.project.calculationEngine.resourceLogicProgram(resource);
-    }
-    /**
-     * Shows details of a module.
-     * @param moduleName name of a module
-     * @returns details of a module.
-     */
-    async showModule(moduleName) {
-        const moduleDetails = await this.project.module(moduleName);
-        if (!moduleDetails) {
-            throw new Error(`Module '${moduleName}' does not exist in the project`);
+        /**
+         * Shows all cards (either template or project cards) from a project.
+         * @param cardsFrom - The location from which to look for cards. Either from the project, templates or both.
+         * @returns cards list array
+         */
+        async showCards(cardsFrom) {
+            return this.project.listCards(cardsFrom);
         }
-        return moduleDetails;
-    }
-    /**
-     * Shows hubs of the project.
-     * @returns list of hubs.
-     */
-    async showHubs() {
-        // Ensure module list is up to date before showing
-        await this.fetchCmd.ensureModuleListUpToDate();
-        return this.project.configuration.hubs;
-    }
-    /**
-     * Returns all project cards in the project. Cards don't have content and nor metadata.
-     * @returns array of cards
-     */
-    showProjectCards() {
-        return this.project.showProjectCards();
-    }
-    /**
-     * Shows all modules (if any) in a project.
-     * @returns all modules in a project.
-     */
-    showModules() {
-        return this.project.resources.moduleNames().sort();
-    }
-    /**
-     * Shows details of a particular project.
-     * @returns project information
-     */
-    async showProject() {
-        return this.project.show();
-    }
-    /**
-     * Shows report results for a given report name and card key.
-     * @param reportName Name of the report to show
-     * @param cardKey Card key to use for the report
-     * @param parameters Additional parameters for the report
-     * @param context Context for resource (includes a project instance)
-     * @param outputPath Optional output path for the report
-     * @returns Report results as a string
-     * @throws Error if the report does not exist
-     */
-    async showReportResults(reportName, cardKey, parameters, context, outputPath) {
-        if (!this.project.resources
-            .reports()
-            .some((report) => report.data?.name === reportName)) {
-            throw new Error(`Report '${reportName}' does not exist`);
+        /**
+         * Shows the content of a logic program.
+         * @param cardKey The key of the card.
+         * @returns the content of the logic program.
+         */
+        async showCardLogicProgram(cardKey) {
+            return this.project.calculationEngine.cardLogicProgram(cardKey);
+        }
+        /**
+         * Shows all card types in a project.
+         * @returns array of card type details
+         */
+        async showCardTypesWithDetails() {
+            const container = [];
+            for (const cardType of this.project.resources.cardTypes()) {
+                if (cardType.data) {
+                    container.push(cardType.data);
+                }
+            }
+            return container;
         }
-        await this.project.calculationEngine.generate();
-        const reportMacro = new ReportMacro(new TaskQueue());
-        let result = await reportMacro.handleStatic({
-            project: this.project,
-            cardKey: cardKey,
-            mode: 'static',
-            context,
-        }, { name: reportName, ...parameters });
-        result = await evaluateMacros(result, {
-            project: this.project,
-            cardKey: cardKey,
-            mode: 'static',
-            context,
-        });
-        // Show the results either in the console or write to a file.
-        if (outputPath) {
+        /**
+         * Shows importable modules.
+         * @param showAll - When true, shows all importable modules, even if they have already been imported
+         * @param showDetails - When true, shows all properties of modules, not just name.
+         * @returns list of modules; the list content depends on the parameters provided
+         *          by default it is a list of module names that could be imported into the project,
+         *          with 'showDetails' true, instead of name, the list consists of full details of the modules
+         *          with 'showAll' true, the list consists of all modules in the hubs, even if they have already been imported
+         *          Note that the two boolean options can be combined.
+         */
+        async showImportableModules(showAll, showDetails) {
             try {
-                await writeFile(outputPath, result ?? '', 'utf-8');
+                // Ensure module list is up to date before showing
+                await this.fetchCmd.ensureModuleListUpToDate();
+                const moduleList = (await readJsonFile(resolve(this.project.basePath, MODULE_LIST_FULL_PATH))).modules;
+                const currentModules = this.project.resources.moduleNames();
+                const nonImportedModules = moduleList.filter((item) => {
+                    return !currentModules.some((module) => item.name === module);
+                });
+                if (showAll && showDetails) {
+                    return moduleList;
+                }
+                if (showAll) {
+                    return moduleList?.map((item) => item?.name);
+                }
+                if (showDetails) {
+                    return nonImportedModules;
+                }
+                // By default return the non-imported modules
+                return nonImportedModules.map((item) => item?.name);
             }
             catch (error) {
                 if (error instanceof Error) {
-                    throw new Error(`Failed to write report to ${outputPath}: ${error.message}`);
+                    this.logger.error(error.message);
                 }
+                // Module list doesn't exist, return empty list
+                return [];
             }
         }
-        return outputPath ? '' : (result ?? '');
-    }
-    async showResource(name, arg2, arg3) {
-        const hasResourceType = typeof arg2 === 'string';
-        const resourceType = hasResourceType ? arg2 : null;
-        const showUse = hasResourceType ? arg3 : arg2;
-        const type = this.project.resources.extractType(name);
-        if (resourceType !== null && resourceType !== type) {
-            throw new Error(`While fetching '${name}': Expected type '${resourceType}', but got '${type}' instead`);
+        /**
+         * Returns all unique labels in a project
+         * @returns labels in a list
+         */
+        async showLabels() {
+            const cards = flattenCardArray(this.project.showProjectCards(), this.project);
+            const templateCards = this.project.allTemplateCards();
+            const labels = this.collectLabels([...cards, ...templateCards]);
+            return Array.from(new Set(labels));
         }
-        const resource = this.project.resources.byType(name, type);
-        const [details, usage] = await Promise.all([
-            resource?.show(),
-            showUse ? resource?.usage() : [],
-        ]);
-        if (showUse) {
-            return {
-                ...details,
-                usedIn: [...usage],
-            };
+        /**
+         * Shows the content of a logic program.
+         * @param resource Name of the resource.
+         * @returns the content of the logic program.
+         */
+        async showLogicProgram(resource) {
+            return this.project.calculationEngine.resourceLogicProgram(resource);
         }
-        else {
-            return details;
+        /**
+         * Shows details of a module.
+         * @param moduleName name of a module
+         * @returns details of a module.
+         */
+        async showModule(moduleName) {
+            const moduleDetails = await this.project.module(moduleName);
+            if (!moduleDetails) {
+                throw new Error(`Module '${moduleName}' does not exist in the project`);
+            }
+            return moduleDetails;
         }
-    }
-    /**
-     * Shows all available resources of a given type.
-     * @param type Name of resources to return (in plural form, e.g. 'templates')
-     * @returns sorted array of resources
-     */
-    async showResources(type) {
-        const func = this.resourceFunctions[type];
-        if (!func)
-            return [];
-        return func().sort();
-    }
-    /**
-     * Shows all templates with full details in a project.
-     * @returns all templates in a project.
-     */
-    async showTemplatesWithDetails() {
-        const templates = [];
-        for (const template of this.project.resources.templates()) {
-            templates.push(template.show());
+        /**
+         * Shows hubs of the project.
+         * @returns list of hubs.
+         */
+        async showHubs() {
+            // Ensure module list is up to date before showing
+            await this.fetchCmd.ensureModuleListUpToDate();
+            return this.project.configuration.hubs;
         }
-        return templates;
-    }
-    /**
-     * Shows all workflows with full details in a project.
-     * @returns workflows with full details
-     */
-    showWorkflowsWithDetails() {
-        const workflows = [];
-        for (const workflow of this.project.resources.workflows()) {
-            workflows.push(workflow.data);
+        /**
+         * Returns all project cards in the project. Cards don't have content and nor metadata.
+         * @returns array of cards
+         */
+        async showProjectCards() {
+            return this.project.showProjectCards();
         }
-        return workflows;
-    }
-}
+        /**
+         * Shows all modules (if any) in a project.
+         * @returns all modules in a project.
+         */
+        async showModules() {
+            return this.project.resources.moduleNames().sort();
+        }
+        /**
+         * Shows details of a particular project.
+         * @returns project information
+         */
+        async showProject() {
+            return this.project.show();
+        }
+        /**
+         * Shows report results for a given report name and card key.
+         * @param reportName Name of the report to show
+         * @param cardKey Card key to use for the report
+         * @param parameters Additional parameters for the report
+         * @param context Context for resource (includes a project instance)
+         * @param outputPath Optional output path for the report
+         * @returns Report results as a string
+         * @throws Error if the report does not exist
+         */
+        async showReportResults(reportName, cardKey, parameters, context, outputPath) {
+            if (!this.project.resources
+                .reports()
+                .some((report) => report.data?.name === reportName)) {
+                throw new Error(`Report '${reportName}' does not exist`);
+            }
+            await this.project.calculationEngine.generate();
+            const reportMacro = new ReportMacro(new TaskQueue());
+            let result = await reportMacro.handleStatic({
+                project: this.project,
+                cardKey: cardKey,
+                mode: 'static',
+                context,
+            }, { name: reportName, ...parameters });
+            result = await evaluateMacros(result, {
+                project: this.project,
+                cardKey: cardKey,
+                mode: 'static',
+                context,
+            });
+            // Show the results either in the console or write to a file.
+            if (outputPath) {
+                try {
+                    await writeFile(outputPath, result ?? '', 'utf-8');
+                }
+                catch (error) {
+                    if (error instanceof Error) {
+                        throw new Error(`Failed to write report to ${outputPath}: ${error.message}`, { cause: error });
+                    }
+                }
+            }
+            return outputPath ? '' : (result ?? '');
+        }
+        async showResource(name, arg2, arg3) {
+            return this.project.lock.read(async () => {
+                const hasResourceType = typeof arg2 === 'string';
+                const resourceType = hasResourceType ? arg2 : null;
+                const showUse = hasResourceType ? arg3 : arg2;
+                const type = this.project.resources.extractType(name);
+                if (resourceType !== null && resourceType !== type) {
+                    throw new Error(`While fetching '${name}': Expected type '${resourceType}', but got '${type}' instead`);
+                }
+                const resource = this.project.resources.byType(name, type);
+                const [details, usage] = await Promise.all([
+                    resource?.show(),
+                    showUse ? resource?.usage() : [],
+                ]);
+                if (showUse) {
+                    return {
+                        ...details,
+                        usedIn: [...usage],
+                    };
+                }
+                else {
+                    return details;
+                }
+            });
+        }
+        /**
+         * Shows all available resources of a given type.
+         * @param type Name of resources to return (in plural form, e.g. 'templates')
+         * @returns sorted array of resources
+         */
+        async showResources(type) {
+            const func = this.resourceFunctions[type];
+            if (!func)
+                return [];
+            return func().sort();
+        }
+        /**
+         * Shows all templates with full details in a project.
+         * @returns all templates in a project.
+         */
+        async showTemplatesWithDetails() {
+            const templates = [];
+            for (const template of this.project.resources.templates()) {
+                templates.push(template.show());
+            }
+            return templates;
+        }
+        /**
+         * Shows all workflows with full details in a project.
+         * @returns workflows with full details
+         */
+        async showWorkflowsWithDetails() {
+            const workflows = [];
+            for (const workflow of this.project.resources.workflows()) {
+                workflows.push(workflow.data);
+            }
+            return workflows;
+        }
+    };
+})();
+export { Show };
 //# sourceMappingURL=show.js.map