@cyberismo/data-handler 0.0.2

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/import.d.ts

@@ -0,0 +1,53 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2024
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  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/>.
+*/
+import { type Create } from './index.js';
+import type { ModuleSettingOptions } from '../interfaces/project-interfaces.js';
+import type { Project } from '../containers/project.js';
+export declare class Import {
+    private project;
+    private createCmd;
+    private moduleManager;
+    constructor(project: Project, createCmd: Create);
+    /**
+     * Imports cards based on a csv file
+     * @param csvFilePath path to the csv file
+     * @param parentCardKey the cards in the csv file will be created under this card
+     * @returns card keys of the imported cards
+     */
+    importCsv(csvFilePath: string, parentCardKey?: string): Promise<string[]>;
+    /**
+     * Imports a module to a project. Copies resources to the project.
+     * Resources will be added to a new directory under '.cards/modules'.
+     * The name of the new folder will be module's prefix.
+     *
+     * Note that file references are relative, and thus URI must be
+     * 'file:<relative path>', instead of 'file://<relative path>'.
+     *
+     * @param source Path to module that will be imported
+     * @param destination Path to project that will receive the imported module
+     * @param options Additional options for module import. Optional.
+     *        branch: Git branch for module from Git.
+     *        private: If true, uses credentials to clone the repository
+     */
+    importModule(source: string, destination?: string, options?: ModuleSettingOptions): Promise<void>;
+    /**
+     * Updates all imported modules.
+     */
+    updateAllModules(): Promise<void>;
+    /**
+     * Updates 'moduleName' module from its source.
+     * Modules using gitUrl, are first copied to .temp
+     * @param moduleName module name (prefix) to update
+     */
+    updateExistingModule(moduleName: string): Promise<void>;
+}

package/dist/commands/import.js

@@ -0,0 +1,133 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2024
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  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/>.
+*/
+import { Validate } from './index.js';
+import { ModuleManager } from '../module-manager.js';
+import { readCsvFile } from '../utils/csv.js';
+import { resourceName } from '../utils/resource-utils.js';
+import { TemplateResource } from '../resources/template-resource.js';
+export class Import {
+    project;
+    createCmd;
+    moduleManager;
+    constructor(project, createCmd) {
+        this.project = project;
+        this.createCmd = createCmd;
+        this.moduleManager = new ModuleManager(this.project, this);
+    }
+    /**
+     * Imports cards based on a csv file
+     * @param csvFilePath path to the csv file
+     * @param parentCardKey the cards in the csv file will be created under this card
+     * @returns card keys of the imported cards
+     */
+    async importCsv(csvFilePath, parentCardKey) {
+        const csv = await readCsvFile(csvFilePath);
+        const isValid = Validate.getInstance().validateJson(csv, 'csvSchema');
+        if (isValid.length !== 0) {
+            throw new Error(isValid);
+        }
+        const importedCards = [];
+        for (const row of csv) {
+            const { title, template, description, labels, ...customFields } = row;
+            const templateResource = new TemplateResource(this.project, resourceName(template));
+            const templateObject = templateResource.templateObject();
+            if (!templateObject) {
+                throw new Error(`Template '${template}' not found`);
+            }
+            const templateCards = await templateObject.cards();
+            if (templateCards.length !== 1) {
+                console.warn(`Template '${template}' for card '${title}' does not have exactly one card. Skipping row.`);
+                continue;
+            }
+            // Create card
+            const cards = await this.createCmd.createCard(template, parentCardKey);
+            if (cards.length !== 1) {
+                throw new Error('Card not created');
+            }
+            const cardKey = cards[0].key;
+            const card = await this.project.findSpecificCard(cardKey, {
+                metadata: true,
+            });
+            const cardType = await this.project.resource(card?.metadata?.cardType || '');
+            if (!cardType) {
+                throw new Error(`Card type not found for card ${cardKey}`);
+            }
+            if (description) {
+                await this.project.updateCardContent(cardKey, description);
+            }
+            if (labels) {
+                for (const label of labels.split(' ')) {
+                    try {
+                        await this.createCmd.createLabel(cardKey, label);
+                    }
+                    catch (e) {
+                        console.error(`Failed to create label ${label}: ${e instanceof Error ? e.message : 'Unknown error'}`);
+                    }
+                }
+            }
+            await this.project.updateCardMetadataKey(cardKey, 'title', title);
+            for (const [key, value] of Object.entries(customFields)) {
+                if (cardType.customFields.find((field) => field.name === key)) {
+                    await this.project.updateCardMetadataKey(cardKey, key, value);
+                }
+            }
+            importedCards.push(cardKey);
+        }
+        return importedCards;
+    }
+    /**
+     * Imports a module to a project. Copies resources to the project.
+     * Resources will be added to a new directory under '.cards/modules'.
+     * The name of the new folder will be module's prefix.
+     *
+     * Note that file references are relative, and thus URI must be
+     * 'file:<relative path>', instead of 'file://<relative path>'.
+     *
+     * @param source Path to module that will be imported
+     * @param destination Path to project that will receive the imported module
+     * @param options Additional options for module import. Optional.
+     *        branch: Git branch for module from Git.
+     *        private: If true, uses credentials to clone the repository
+     */
+    async importModule(source, destination, options) {
+        const gitModule = source.startsWith('https');
+        const modulePrefix = gitModule
+            ? await this.moduleManager.importGitModule(source, options)
+            : await this.moduleManager.importFileModule(source, destination);
+        if (!modulePrefix) {
+            throw new Error(`Cannot find prefix for imported module '${source}'. Import cancelled.`);
+        }
+        // Add module as a dependency.
+        return this.project.importModule({
+            name: modulePrefix,
+            branch: options ? options.branch : undefined,
+            private: options ? options.private : undefined,
+            location: gitModule ? source : `file:${source}`,
+        });
+    }
+    /**
+     * Updates all imported modules.
+     */
+    async updateAllModules() {
+        return this.moduleManager.update();
+    }
+    /**
+     * Updates 'moduleName' module from its source.
+     * Modules using gitUrl, are first copied to .temp
+     * @param moduleName module name (prefix) to update
+     */
+    async updateExistingModule(moduleName) {
+        await this.moduleManager.importFileModule(moduleName);
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.d.ts

@@ -0,0 +1,26 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2025
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation. This program is distributed in the hope that it
+  will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+  General Public License for more 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/>.
+*/
+import { Calculate } from './calculate.js';
+import { Create } from './create.js';
+import { Edit } from './edit.js';
+import { Export } from './export.js';
+import { ExportSite } from './export-site.js';
+import { Import } from './import.js';
+import { Move } from './move.js';
+import { Remove } from './remove.js';
+import { Rename } from './rename.js';
+import { Show } from './show.js';
+import { Transition } from './transition.js';
+import { Update } from './update.js';
+import { Validate } from './validate.js';
+export { Calculate, Create, Edit, Export, ExportSite, Import, Move, Remove, Rename, Show, Transition, Update, Validate, };

package/dist/commands/index.js

@@ -0,0 +1,27 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2025
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation. This program is distributed in the hope that it
+  will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+  General Public License for more 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/>.
+*/
+import { Calculate } from './calculate.js';
+import { Create } from './create.js';
+import { Edit } from './edit.js';
+import { Export } from './export.js';
+import { ExportSite } from './export-site.js';
+import { Import } from './import.js';
+import { Move } from './move.js';
+import { Remove } from './remove.js';
+import { Rename } from './rename.js';
+import { Show } from './show.js';
+import { Transition } from './transition.js';
+import { Update } from './update.js';
+import { Validate } from './validate.js';
+export { Calculate, Create, Edit, Export, ExportSite, Import, Move, Remove, Rename, Show, Transition, Update, Validate, };
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EACL,SAAS,EACT,MAAM,EACN,IAAI,EACJ,MAAM,EACN,UAAU,EACV,MAAM,EACN,IAAI,EACJ,MAAM,EACN,MAAM,EACN,IAAI,EACJ,UAAU,EACV,MAAM,EACN,QAAQ,GACT,CAAC"}

package/dist/commands/move.d.ts

@@ -0,0 +1,55 @@
+/**
+    Cyberismo
+    Copyright © Cyberismo Ltd and contributors 2024
+
+    This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation.
+
+    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more 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/>.
+*/
+import type { Calculate } from './index.js';
+import { type Project } from '../containers/project.js';
+export declare class Move {
+    private project;
+    private calculateCmd;
+    constructor(project: Project, calculateCmd: Calculate);
+    private getCard;
+    private getSiblings;
+    private rebalanceCards;
+    private rebalanceProjectRecursively;
+    /**
+     * Moves card from 'destination' to 'source'.
+     * @param source source card to move
+     * @param destination destination card where source card will be moved to; or to root
+     */
+    moveCard(source: string, destination: string): Promise<void>;
+    /**
+     * Ranks card using position given as 'index'.
+     * @param cardKey card key
+     * @param index to which position should card be ranked to
+     */
+    rankByIndex(cardKey: string, index: number): Promise<void>;
+    /**
+     * Sets the rank of a card to be after another card.
+     * @param cardKey Card to rank
+     * @param beforeCardKey Card key after which the card will be ranked
+     */
+    rankCard(cardKey: string, beforeCardKey: string): Promise<void>;
+    /**
+     * Ranks card first.
+     * @param cardKey card key
+     */
+    rankFirst(cardKey: string): Promise<void>;
+    /**
+     *  Rebalances the ranks of the children of a card.
+     * @param parentCardKey parent card key
+     */
+    rebalanceChildren(parentCardKey: string): Promise<void>;
+    /**
+     * Rebalances the ranks of the cards in the whole project, including templates
+     * Can be used even if the ranks do not exist
+     */
+    rebalanceProject(): Promise<void>;
+}

package/dist/commands/move.js

@@ -0,0 +1,341 @@
+/**
+    Cyberismo
+    Copyright © Cyberismo Ltd and contributors 2024
+
+    This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation.
+
+    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more 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/>.
+*/
+// node
+import { join, sep } from 'node:path';
+import { ActionGuard } from '../permissions/action-guard.js';
+import { copyDir, deleteDir } from '../utils/file-utils.js';
+import { ResourcesFrom } from '../containers/project.js';
+import { EMPTY_RANK, FIRST_RANK, getRankAfter, getRankBetween, rebalanceRanks, sortItems, } from '../utils/lexorank.js';
+import { isTemplateCard } from '../utils/card-utils.js';
+import { resourceName } from '../utils/resource-utils.js';
+import { TemplateResource } from '../resources/template-resource.js';
+// @todo - we should have project wide constants, so that if we need them, only the const value needs to be changed.
+const ROOT = 'root';
+export class Move {
+    project;
+    calculateCmd;
+    constructor(project, calculateCmd) {
+        this.project = project;
+        this.calculateCmd = calculateCmd;
+    }
+    // Fetches a card (either template or project card).
+    async getCard(cardKey, options) {
+        let card;
+        const templateCard = await this.project.isTemplateCard(cardKey);
+        if (templateCard) {
+            card = (await this.project.allTemplateCards(options)).find((card) => card.key === cardKey);
+        }
+        else {
+            card = await this.project.findSpecificCard(cardKey, options);
+        }
+        if (!card) {
+            throw new Error('Card was not found from the project');
+        }
+        return card;
+    }
+    // Returns children of a parent card or root cards
+    async getSiblings(card) {
+        const parentCardKey = card.parent || ROOT;
+        // since we don't know if 'root' is templateRoot or cardRoot, we need to check the card
+        if (parentCardKey === ROOT) {
+            if (isTemplateCard(card)) {
+                const template = this.project.createTemplateObjectFromCard(card);
+                if (!template) {
+                    throw new Error(`Cannot find template for the template card '${card.key}'`);
+                }
+                if (card?.path.includes(`${sep}modules${sep}`)) {
+                    throw new Error(`Cannot rank module cards`);
+                }
+                return template.cards();
+            }
+        }
+        let parentCard;
+        if (parentCardKey !== ROOT) {
+            parentCard = await this.project.findSpecificCard(parentCardKey, {
+                children: true,
+                metadata: true,
+            });
+            if (!parentCard) {
+                throw new Error(`Card ${parentCardKey} not found from project`);
+            }
+        }
+        if (parentCard) {
+            return parentCard.children || [];
+        }
+        return this.project.showProjectCards();
+    }
+    //
+    async rebalanceCards(cards) {
+        const ranks = rebalanceRanks(cards.length);
+        cards = sortItems(cards, (item) => item.metadata?.rank || 'z');
+        for (let i = 0; i < cards.length; i++) {
+            const card = cards[i];
+            await this.project.updateCardMetadataKey(card.key, 'rank', ranks[i]);
+        }
+    }
+    // Rebalances the project recursively.
+    async rebalanceProjectRecursively(cards) {
+        const ranks = rebalanceRanks(cards.length);
+        cards = sortItems(cards, (item) => item.metadata?.rank || 'z');
+        for (let i = 0; i < cards.length; i++) {
+            const card = cards[i];
+            await this.project.updateCardMetadataKey(card.key, 'rank', ranks[i]);
+            if (card.children && card.children.length > 0) {
+                await this.rebalanceProjectRecursively(card.children);
+            }
+        }
+    }
+    /**
+     * Moves card from 'destination' to 'source'.
+     * @param source source card to move
+     * @param destination destination card where source card will be moved to; or to root
+     */
+    async moveCard(source, destination) {
+        if (source === ROOT) {
+            throw new Error('Cannot move "root"');
+        }
+        if (source === destination) {
+            throw new Error(`Card cannot be moved to itself`);
+        }
+        const promiseContainer = [];
+        promiseContainer.push(this.project.findSpecificCard(source));
+        if (destination !== ROOT) {
+            promiseContainer.push(this.project.findSpecificCard(destination));
+        }
+        else {
+            const returnObject = {
+                key: '',
+                path: this.project.paths.cardRootFolder,
+                children: [],
+                attachments: [],
+            };
+            promiseContainer.push(Promise.resolve(returnObject));
+        }
+        const [sourceCard, destinationCard] = await Promise.all(promiseContainer);
+        if (!sourceCard) {
+            throw new Error(`Card ${source} not found from project`);
+        }
+        if (!destinationCard) {
+            throw new Error(`Card ${destination} not found from project`);
+        }
+        if (destinationCard.path.includes(source)) {
+            throw new Error(`Card cannot be moved to inside itself`);
+        }
+        // Imported templates cannot be modified.
+        if (destinationCard.path.includes(`${sep}modules`) ||
+            sourceCard.path.includes(`${sep}modules${sep}`)) {
+            throw new Error(`Cannot modify imported module templates`);
+        }
+        const bothTemplateCards = isTemplateCard(sourceCard) && isTemplateCard(destinationCard);
+        const bothProjectCards = this.project.hasCard(sourceCard.key) &&
+            this.project.hasCard(destinationCard.key);
+        if (!(bothTemplateCards || bothProjectCards)) {
+            throw new Error(`Cards cannot be moved from project to template or vice versa`);
+        }
+        const destinationPath = destination === ROOT
+            ? join(this.project.paths.cardRootFolder, sourceCard.key)
+            : join(destinationCard.path, 'c', sourceCard.key);
+        // if the card is already in the destination, do nothing
+        if (sourceCard.path === destinationPath) {
+            return;
+        }
+        // if both are project cards, make sure source card can be moved
+        const actionGuard = new ActionGuard(this.calculateCmd);
+        await actionGuard.checkPermission('move', source);
+        // rerank the card in the new location
+        // it will be the last one in the new location
+        let children;
+        if (destination !== ROOT) {
+            const parent = await this.project.findSpecificCard(destination, {
+                children: true,
+                metadata: true,
+            });
+            if (!parent) {
+                throw new Error(`Parent card ${destination} not found from project`);
+            }
+            children = parent.children;
+        }
+        else {
+            children = await this.project.showProjectCards();
+        }
+        if (!children) {
+            throw new Error(`Children not found from card ${destination}`);
+        }
+        children = sortItems(children, (item) => item?.metadata?.rank || '1|z');
+        const lastChild = children[children.length - 1];
+        const rank = lastChild && lastChild.metadata
+            ? getRankAfter(lastChild.metadata.rank)
+            : FIRST_RANK;
+        await this.project.updateCardMetadataKey(sourceCard.key, 'rank', rank);
+        await copyDir(sourceCard.path, destinationPath);
+        await deleteDir(sourceCard.path);
+    }
+    /**
+     * Ranks card using position given as 'index'.
+     * @param cardKey card key
+     * @param index to which position should card be ranked to
+     */
+    async rankByIndex(cardKey, index) {
+        if (index < 0) {
+            throw new Error(`Index must be greater than 0`);
+        }
+        if (index === 0) {
+            await this.rankFirst(cardKey);
+            return;
+        }
+        const card = await this.project.findSpecificCard(cardKey, {
+            metadata: true,
+            parent: true,
+        });
+        if (!card || !card.parent) {
+            throw new Error(`Card ${cardKey} not found from project`);
+        }
+        const children = sortItems(await this.getSiblings(card), (item) => item.metadata?.rank || EMPTY_RANK);
+        if (!children || children.length === 0) {
+            throw new Error(`Children not found from card ${card.parent}`);
+        }
+        if (children.length < index) {
+            throw new Error(`Index ${index} is out of bounds`);
+        }
+        await this.rankCard(cardKey, children[index - 1].key);
+    }
+    /**
+     * Sets the rank of a card to be after another card.
+     * @param cardKey Card to rank
+     * @param beforeCardKey Card key after which the card will be ranked
+     */
+    async rankCard(cardKey, beforeCardKey) {
+        const card = await this.project.findSpecificCard(cardKey, {
+            metadata: true,
+            parent: true,
+        });
+        if (!card) {
+            throw new Error(`Card ${cardKey} not found from project`);
+        }
+        const beforeCard = await this.project.findSpecificCard(beforeCardKey, {
+            metadata: true,
+            parent: true,
+        });
+        if (!beforeCard) {
+            throw new Error(`Card ${beforeCardKey} not found from project`);
+        }
+        if (beforeCard.parent !== card.parent) {
+            throw new Error(`Cards must be from the same parent`);
+        }
+        const children = sortItems(await this.getSiblings(beforeCard), (item) => item.metadata?.rank || EMPTY_RANK);
+        if (!children) {
+            throw new Error(`Children not found from card ${beforeCard.parent}`);
+        }
+        const beforeCardIndex = children.findIndex((child) => child.key === beforeCard.key);
+        if (beforeCardIndex === -1) {
+            throw new Error(`Card ${beforeCardKey} is not a child of ${beforeCard.parent}`);
+        }
+        if (children[beforeCardIndex].key === cardKey ||
+            children[beforeCardIndex + 1]?.key === cardKey) {
+            throw new Error(`Card ${cardKey} is already in the correct position`);
+        }
+        if (beforeCardIndex === children.length - 1) {
+            await this.project.updateCardMetadataKey(cardKey, 'rank', getRankAfter(beforeCard.metadata?.rank));
+        }
+        else {
+            await this.project.updateCardMetadataKey(cardKey, 'rank', getRankBetween(beforeCard.metadata?.rank, children[beforeCardIndex + 1].metadata?.rank));
+        }
+    }
+    /**
+     * Ranks card first.
+     * @param cardKey card key
+     */
+    async rankFirst(cardKey) {
+        const card = await this.getCard(cardKey, {
+            metadata: true,
+            parent: true,
+        });
+        const children = sortItems(await this.getSiblings(card), (item) => item.metadata?.rank || EMPTY_RANK);
+        if (!children || children.length === 0) {
+            throw new Error(`Children not found from card ${card.parent}`);
+        }
+        if (children[0].key === cardKey && children[0].metadata?.rank) {
+            return;
+        }
+        const firstRank = children[0].metadata?.rank;
+        if (!firstRank) {
+            await this.project.updateCardMetadataKey(cardKey, 'rank', FIRST_RANK);
+            return;
+        }
+        // Set the rank to be the first one
+        if (firstRank === FIRST_RANK) {
+            // if the first card is already at the first rank, we need to move the card to the next one
+            const secondRank = children[1].metadata?.rank;
+            if (!secondRank) {
+                throw new Error(`Second rank not found`);
+            }
+            const rankBetween = getRankBetween(firstRank, secondRank);
+            await this.project.updateCardMetadataKey(children[0].key, 'rank', rankBetween);
+            await this.project.updateCardMetadataKey(cardKey, 'rank', firstRank);
+        }
+        else {
+            // if the card is not at the first rank, we just use the first rank
+            await this.project.updateCardMetadataKey(cardKey, 'rank', FIRST_RANK);
+        }
+    }
+    /**
+     *  Rebalances the ranks of the children of a card.
+     * @param parentCardKey parent card key
+     */
+    async rebalanceChildren(parentCardKey) {
+        const parentCard = await this.project.findSpecificCard(parentCardKey, {
+            children: true,
+            metadata: true,
+        });
+        if (!parentCard || !parentCard.children) {
+            throw new Error(`Card ${parentCardKey} not found from project`);
+        }
+        await this.rebalanceCards(parentCard.children);
+    }
+    /**
+     * Rebalances the ranks of the cards in the whole project, including templates
+     * Can be used even if the ranks do not exist
+     */
+    async rebalanceProject() {
+        const cards = await this.project.showProjectCards();
+        await this.rebalanceProjectRecursively(cards);
+        // rebalance templates
+        const templates = await this.project.templates(ResourcesFrom.localOnly);
+        for (const template of templates) {
+            const templateResource = new TemplateResource(this.project, resourceName(template.name));
+            const templateObject = templateResource.templateObject();
+            if (!templateObject) {
+                throw new Error(`Template '${template.name}' not found`);
+            }
+            const templateCards = await templateObject.cards('', {
+                parent: true,
+                metadata: true,
+            });
+            const cardGroups = templateCards.reduce((result, card) => {
+                // template card root cards have a parent(the template itself) so this shouldn't happen
+                if (!card.parent) {
+                    return result;
+                }
+                // if the parent does not exist yet in the result, we create it
+                if (!result[card.parent]) {
+                    result[card.parent] = [];
+                }
+                result[card.parent].push(card);
+                return result;
+            }, {});
+            for (const [, cards] of Object.entries(cardGroups)) {
+                await this.rebalanceCards(cards);
+            }
+        }
+    }
+}
+//# sourceMappingURL=move.js.map