@cyberismo/data-handler 0.0.2

package/dist/utils/clingo-parser.js

@@ -0,0 +1,403 @@
+/**
+    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/>.
+*/
+/**
+ * This function reverses the encoding made by the "encodeClingoValue" function
+ */
+export function decodeClingoValue(value) {
+    return value.replace(/\\([n\\"])/g, (_, char) => {
+        if (char === 'n') {
+            return '\n';
+        }
+        return char;
+    });
+}
+class ClingoParser {
+    keywords = [
+        'queryError',
+        'result',
+        'childResult',
+        'field',
+        'enumField',
+        'listField',
+        'label',
+        'link',
+        'transitionDenied',
+        'movingCardDenied',
+        'deletingCardDenied',
+        'editingFieldDenied',
+        'editingContentDenied',
+        'notification',
+        'policyCheckFailure',
+        'policyCheckSuccess',
+        'order',
+    ];
+    result = {
+        results: [],
+        error: null,
+    };
+    // The queue now stores the parameters instead of functions
+    resultQueue = [];
+    childResultQueue = [];
+    tempResults = {};
+    orderQueue = [];
+    collections = new Set();
+    reset() {
+        this.result = {
+            results: [],
+            error: null,
+        };
+        this.resultQueue = [];
+        this.childResultQueue = [];
+        this.tempResults = {};
+        this.orderQueue = [];
+        this.collections = new Set();
+    }
+    /**
+     * Command handlers for each possible keyword
+     * All of them will get parameters as strings
+     * You can trust that clingo will always provide the correct number of parameters / types
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    commandHandlers = {
+        queryError: (message, ...params) => {
+            this.result.error = `${message}${params.length > 1 ? ` ${params.join(', ')}` : ''}`;
+        },
+        result: (key) => {
+            this.resultQueue.push({ key });
+        },
+        childResult: (parentKey, childKey, collection) => {
+            this.childResultQueue.push({ parentKey, childKey, collection });
+            this.collections.add(collection);
+        },
+        enumField: async (key, fieldName, fieldValue, index, displayValue) => {
+            const res = this.getOrInitResult(key);
+            const decoded = decodeClingoValue(fieldValue);
+            const parsedIndex = parseInt(index, 10);
+            res[fieldName] = {
+                value: decoded,
+                index: parsedIndex,
+                displayValue,
+            };
+        },
+        // NOTE: Must be tested in INTDEV-623
+        listField: async (key, fieldName, fieldValue, index, displayValue) => {
+            const res = this.getOrInitResult(key);
+            const decoded = decodeClingoValue(fieldValue);
+            if (!res[fieldName] || !Array.isArray(res[fieldName])) {
+                res[fieldName] = [];
+            }
+            const parsedIndex = parseInt(index, 10);
+            res[fieldName].push({
+                value: decoded,
+                index: parsedIndex,
+                displayValue,
+            });
+        },
+        field: async (key, fieldName, fieldValue, dataType) => {
+            const res = this.getOrInitResult(key);
+            const decoded = decodeClingoValue(fieldValue);
+            switch (dataType) {
+                case 'shortText':
+                case 'longText':
+                case 'person':
+                case 'date':
+                case 'dateTime':
+                    res[fieldName] = decoded;
+                    break;
+                case 'number':
+                    res[fieldName] = parseFloat(decoded);
+                    break;
+                case 'integer':
+                    res[fieldName] = parseInt(decoded, 10);
+                    break;
+                case 'boolean':
+                    res[fieldName] = fieldValue === 'true';
+                    break;
+            }
+        },
+        label: (key, label) => {
+            const res = this.getOrInitResult(key);
+            res.labels.push(label);
+        },
+        link: (key, // key is the card itself
+        cardKey, // cardKey is otherCard this is being linked to
+        title, linkType, displayName, direction, linkSource, linkDescription) => {
+            const res = this.getOrInitResult(key);
+            res.links.push({
+                key: cardKey,
+                linkType,
+                displayName,
+                linkDescription,
+                direction,
+                linkSource,
+                title,
+            });
+        },
+        transitionDenied: (key, transitionName, errorMessage) => {
+            const res = this.getOrInitResult(key);
+            res.deniedOperations.transition.push({ transitionName, errorMessage });
+        },
+        movingCardDenied: (key, errorMessage) => {
+            const res = this.getOrInitResult(key);
+            res.deniedOperations.move.push({ errorMessage });
+        },
+        deletingCardDenied: (key, errorMessage) => {
+            const res = this.getOrInitResult(key);
+            res.deniedOperations.delete.push({ errorMessage });
+        },
+        editingFieldDenied: (key, fieldName, errorMessage) => {
+            const res = this.getOrInitResult(key);
+            res.deniedOperations.editField.push({ fieldName, errorMessage });
+        },
+        editingContentDenied: (key, errorMessage) => {
+            const res = this.getOrInitResult(key);
+            res.deniedOperations.editContent.push({ errorMessage });
+        },
+        notification: (key, category, title, message) => {
+            const res = this.getOrInitResult(key);
+            res.notifications.push({ key, category, title, message });
+        },
+        policyCheckFailure: (key, category, title, errorMessage, fieldName) => {
+            const res = this.getOrInitResult(key);
+            res.policyChecks.failures.push({
+                category,
+                title,
+                errorMessage,
+                fieldName,
+            });
+        },
+        policyCheckSuccess: (key, category, title) => {
+            const res = this.getOrInitResult(key);
+            res.policyChecks.successes.push({ category, title });
+        },
+        order: (level, collection, fieldIndex, field, direction) => {
+            const parsedLevel = parseInt(level, 10);
+            const parsedFieldIndex = parseInt(fieldIndex, 10);
+            this.orderQueue.push({
+                level: parsedLevel,
+                collection,
+                fieldIndex: parsedFieldIndex,
+                field,
+                direction,
+            });
+        },
+    };
+    getOrInitResult(key) {
+        if (!this.tempResults[key]) {
+            this.tempResults[key] = {
+                key,
+                labels: [],
+                links: [],
+                notifications: [],
+                policyChecks: { successes: [], failures: [] },
+                deniedOperations: {
+                    transition: [],
+                    move: [],
+                    delete: [],
+                    editField: [],
+                    editContent: [],
+                },
+            };
+        }
+        return this.tempResults[key];
+    }
+    sortByLevel(results, level = 1, currentCollection) {
+        const levelOrders = this.orderQueue
+            .filter((order) => order.level === level &&
+            (currentCollection ? order.collection === currentCollection : true))
+            .sort((a, b) => a.fieldIndex - b.fieldIndex);
+        // Apply sorting instructions for this level/collection if any
+        if (levelOrders.length > 0) {
+            results.sort((a, b) => {
+                for (const { field, direction } of levelOrders) {
+                    const sortOrder = direction === 'ASC' ? -1 : 1;
+                    const firstValue = this.getComparableValue(a[field]);
+                    const secondValue = this.getComparableValue(b[field]);
+                    if (firstValue == null && secondValue == null) {
+                        continue; // both are null, move on to next field
+                    }
+                    else if (firstValue == null) {
+                        return sortOrder; // first is considered less
+                    }
+                    else if (secondValue == null) {
+                        return -sortOrder; // second is considered less
+                    }
+                    // Regular comparison
+                    if (firstValue < secondValue)
+                        return sortOrder;
+                    if (firstValue > secondValue)
+                        return -sortOrder;
+                    // if equal, try next field
+                }
+                // if all fields equal
+                return 0;
+            });
+        }
+        // Recursively sort all known child collections
+        for (const result of results) {
+            for (const childCollection of this.collections) {
+                const childResults = result[childCollection];
+                if (Array.isArray(childResults)) {
+                    this.sortByLevel(childResults, level + 1, childCollection);
+                }
+            }
+        }
+    }
+    getComparableValue(value) {
+        if (value == null) {
+            return null;
+        }
+        if (typeof value === 'object' &&
+            'index' in value &&
+            typeof value.index === 'number') {
+            return value.index;
+        }
+        if (Array.isArray(value)) {
+            const indeces = [];
+            for (const item of value) {
+                if (item != null &&
+                    typeof item === 'object' &&
+                    'index' in item &&
+                    typeof item.index === 'number') {
+                    indeces.push(item.index);
+                }
+            }
+            return Math.min(...indeces);
+        }
+        return value;
+    }
+    applyResultProcessing() {
+        // Process results and parent-child relationships
+        this.resultQueue.forEach(({ key }) => {
+            const res = this.getOrInitResult(key);
+            this.result.results.push(res); // Here we assume the query is correct and returns the data specified by the query
+        });
+        this.childResultQueue.forEach(({ parentKey, childKey, collection }) => {
+            const parent = this.getOrInitResult(parentKey);
+            const child = this.getOrInitResult(childKey);
+            if (!parent[collection] || !Array.isArray(parent[collection])) {
+                parent[collection] = [];
+            }
+            parent[collection].push(child);
+        });
+        this.sortByLevel(this.result.results);
+    }
+    /**
+     * This methods is responsible for converting clingo output to a parsed object
+     * @param input clingo input to parse
+     * @returns
+     */
+    async parseInput(input) {
+        let position = 0;
+        while (position < input.length) {
+            const keywordMatch = this.findKeyword(input, position);
+            if (!keywordMatch) {
+                break;
+            }
+            const { keyword, endIndex } = keywordMatch;
+            position = endIndex;
+            const parsed = this.parseArguments(input, position);
+            if (parsed) {
+                // Apply the command handler with sanitized arguments
+                await this.commandHandlers[keyword](...parsed.args);
+                position = parsed.endPosition; // move position after the argument closing parenthesis
+            }
+        }
+        this.applyResultProcessing();
+        const result = this.result;
+        // Reset the parser state
+        this.reset();
+        return result;
+    }
+    /**
+     * This method finds the next keyword in a string after a specified point
+     * @param input The string which it being searched
+     * @param start The position from which to start the search from
+     * @returns
+     */
+    findKeyword(input, start) {
+        // Create a regex dynamically from the keywords list
+        const regex = new RegExp(`(${this.keywords.join('|')})\\(`, 'g');
+        // Apply the regex starting from the current position
+        regex.lastIndex = start;
+        const match = regex.exec(input);
+        if (match) {
+            return {
+                keyword: match[1], // The matched keyword (first capture group)
+                startIndex: match.index, // Position of the matched keyword
+                endIndex: match.index + match[0].length, // Position after the keyword and opening parenthesis
+            };
+        }
+        return null;
+    }
+    /**
+     * This method is a custom parser, which takes in the whole clingo output and parses the arguments.
+     * Note: Do not decode in this function. It will be handled on a higher level.
+     * As long as this function returns valid clingo, it has done it's responsibility
+     * @param input Clingo output
+     * @param position Position of the command being parsed inside the string
+     * @returns
+     */
+    parseArguments(input, position) {
+        let currentArg = '';
+        const args = [];
+        let insideQuote = false;
+        // calculates how deep into parenthesis we are
+        let insideParanthesis = 0;
+        for (let i = position; i < input.length; i++) {
+            const char = input[i];
+            if (char === '"') {
+                if (i !== 0 && input[i - 1] === '\\') {
+                    currentArg += '"';
+                    continue;
+                }
+                if (!insideQuote && insideParanthesis === 0) {
+                    // We can ignore the chars, which are before a quoted string
+                    currentArg = '';
+                }
+                insideQuote = !insideQuote; // Toggle inside/outside quotes
+                continue;
+            }
+            if (char === ',' && !insideQuote) {
+                if (insideParanthesis > 0) {
+                    currentArg += char;
+                    continue;
+                }
+                args.push(currentArg);
+                currentArg = '';
+                insideParanthesis = 0;
+                continue;
+            }
+            if (char === '(' && !insideQuote) {
+                if (insideParanthesis === 0) {
+                    currentArg = '';
+                }
+                insideParanthesis++;
+            }
+            if (char === ')' && !insideQuote) {
+                if (insideParanthesis-- !== 0) {
+                    currentArg += char;
+                    continue;
+                }
+                args.push(currentArg);
+                return {
+                    args,
+                    endPosition: i + 1,
+                };
+            }
+            currentArg += char;
+        }
+        return null; // No valid arguments found
+    }
+}
+export default ClingoParser;
+//# sourceMappingURL=clingo-parser.js.map

package/dist/utils/clingo-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clingo-parser.js","sourceRoot":"","sources":["../../src/utils/clingo-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AASF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;QAC9C,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,YAAY;IACR,QAAQ,GAAG;QACjB,YAAY;QACZ,QAAQ;QACR,aAAa;QACb,OAAO;QACP,WAAW;QACX,WAAW;QACX,OAAO;QACP,MAAM;QACN,kBAAkB;QAClB,kBAAkB;QAClB,oBAAoB;QACpB,oBAAoB;QACpB,sBAAsB;QACtB,cAAc;QACd,oBAAoB;QACpB,oBAAoB;QACpB,OAAO;KACR,CAAC;IAEM,MAAM,GAA4B;QACxC,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,IAAI;KACZ,CAAC;IAEF,2DAA2D;IACnD,WAAW,GAAsB,EAAE,CAAC;IACpC,gBAAgB,GAIlB,EAAE,CAAC;IACD,WAAW,GAAkC,EAAE,CAAC;IAChD,UAAU,GAMZ,EAAE,CAAC;IACD,WAAW,GAAgB,IAAI,GAAG,EAAE,CAAC;IACrC,KAAK;QACX,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,IAAI;SACZ,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,sEAAsE;IAC9D,eAAe,GAA6B;QAClD,UAAU,EAAE,CAAC,OAAe,EAAE,GAAG,MAAgB,EAAE,EAAE;YACnD,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtF,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;YACtB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,WAAW,EAAE,CAAC,SAAiB,EAAE,QAAgB,EAAE,UAAkB,EAAE,EAAE;YACvE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QACD,SAAS,EAAE,KAAK,EACd,GAAW,EACX,SAAiB,EACjB,UAAkB,EAClB,KAAa,EACb,YAAoB,EACpB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,GAAG,CAAC,SAAS,CAAC,GAAG;gBACf,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,WAAW;gBAClB,YAAY;aACb,CAAC;QACJ,CAAC;QACD,qCAAqC;QACrC,SAAS,EAAE,KAAK,EACd,GAAW,EACX,SAAiB,EACjB,UAAkB,EAClB,KAAa,EACb,YAAoB,EACpB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACtD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACtB,CAAC;YACD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,GAAG,CAAC,SAAS,CAAe,CAAC,IAAI,CAAC;gBACjC,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,WAAW;gBAClB,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QACD,KAAK,EAAE,KAAK,EACV,GAAW,EACX,SAAiB,EACjB,UAAkB,EAClB,QAAkB,EAClB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC9C,QAAQ,QAAQ,EAAE,CAAC;gBACjB,KAAK,WAAW,CAAC;gBACjB,KAAK,UAAU,CAAC;gBAChB,KAAK,QAAQ,CAAC;gBACd,KAAK,MAAM,CAAC;gBACZ,KAAK,UAAU;oBACb,GAAG,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;oBACzB,MAAM;gBACR,KAAK,QAAQ;oBACX,GAAG,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;oBACrC,MAAM;gBACR,KAAK,SAAS;oBACZ,GAAG,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBACvC,MAAM;gBACR,KAAK,SAAS;oBACZ,GAAG,CAAC,SAAS,CAAC,GAAG,UAAU,KAAK,MAAM,CAAC;oBACvC,MAAM;YACV,CAAC;QACH,CAAC;QACD,KAAK,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,EAAE,CACJ,GAAW,EAAE,yBAAyB;QACtC,OAAe,EAAE,+CAA+C;QAChE,KAAa,EACb,QAAgB,EAChB,WAAmB,EACnB,SAAwB,EACxB,UAAiC,EACjC,eAAwB,EACxB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,OAAO;gBACZ,QAAQ;gBACR,WAAW;gBACX,eAAe;gBACf,SAAS;gBACT,UAAU;gBACV,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QACD,gBAAgB,EAAE,CAChB,GAAW,EACX,cAAsB,EACtB,YAAoB,EACpB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,gBAAgB,EAAE,CAAC,GAAW,EAAE,YAAoB,EAAE,EAAE;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,kBAAkB,EAAE,CAAC,GAAW,EAAE,YAAoB,EAAE,EAAE;YACxD,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,kBAAkB,EAAE,CAClB,GAAW,EACX,SAAiB,EACjB,YAAoB,EACpB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,oBAAoB,EAAE,CAAC,GAAW,EAAE,YAAoB,EAAE,EAAE;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,YAAY,EAAE,CACZ,GAAW,EACX,QAAgB,EAChB,KAAa,EACb,OAAe,EACf,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,kBAAkB,EAAE,CAClB,GAAW,EACX,QAAgB,EAChB,KAAa,EACb,YAAoB,EACpB,SAAkB,EAClB,EAAE;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC7B,QAAQ;gBACR,KAAK;gBACL,YAAY;gBACZ,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QACD,kBAAkB,EAAE,CAAC,GAAW,EAAE,QAAgB,EAAE,KAAa,EAAE,EAAE;YACnE,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,EAAE,CACL,KAAa,EACb,UAAkB,EAClB,UAAkB,EAClB,KAAa,EACb,SAAyB,EACzB,EAAE;YACF,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,WAAW;gBAClB,UAAU;gBACV,UAAU,EAAE,gBAAgB;gBAC5B,KAAK;gBACL,SAAS;aACV,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEM,eAAe,CAAC,GAAW;QACjC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG;gBACtB,GAAG;gBACH,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,EAAE;gBACT,aAAa,EAAE,EAAE;gBACjB,YAAY,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAC7C,gBAAgB,EAAE;oBAChB,UAAU,EAAE,EAAE;oBACd,IAAI,EAAE,EAAE;oBACR,MAAM,EAAE,EAAE;oBACV,SAAS,EAAE,EAAE;oBACb,WAAW,EAAE,EAAE;iBAChB;aACF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACO,WAAW,CACjB,OAAqB,EACrB,QAAgB,CAAC,EACjB,iBAA0B;QAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU;aAChC,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,KAAK,KAAK,KAAK;YACrB,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CACtE;aACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAE/C,8DAA8D;QAC9D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACpB,KAAK,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,WAAW,EAAE,CAAC;oBAC/C,MAAM,SAAS,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAE/C,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;oBACrD,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;oBAEtD,IAAI,UAAU,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;wBAC9C,SAAS,CAAC,uCAAuC;oBACnD,CAAC;yBAAM,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;wBAC9B,OAAO,SAAS,CAAC,CAAC,2BAA2B;oBAC/C,CAAC;yBAAM,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;wBAC/B,OAAO,CAAC,SAAS,CAAC,CAAC,4BAA4B;oBACjD,CAAC;oBAED,qBAAqB;oBACrB,IAAI,UAAU,GAAG,WAAW;wBAAE,OAAO,SAAS,CAAC;oBAC/C,IAAI,UAAU,GAAG,WAAW;wBAAE,OAAO,CAAC,SAAS,CAAC;oBAChD,2BAA2B;gBAC7B,CAAC;gBACD,sBAAsB;gBACtB,OAAO,CAAC,CAAC;YACX,CAAC,CAAC,CAAC;QACL,CAAC;QAED,+CAA+C;QAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,eAAe,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC/C,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;gBAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;oBAChC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,KAAK,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,KAAc;QACvC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,IAAI,KAAK;YAChB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAC/B,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IACE,IAAI,IAAI,IAAI;oBACZ,OAAO,IAAI,KAAK,QAAQ;oBACxB,OAAO,IAAI,IAAI;oBACf,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAC9B,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,qBAAqB;QAC3B,iDAAiD;QACjD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,kFAAkF;QACnH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;YACpE,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAE7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YAC1B,CAAC;YAEA,MAAM,CAAC,UAAU,CAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAC,KAAa;QACnC,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,OAAO,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAEvD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM;YACR,CAAC;YAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC;YAC3C,QAAQ,GAAG,QAAQ,CAAC;YAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACpD,IAAI,MAAM,EAAE,CAAC;gBACX,qDAAqD;gBACrD,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;gBACpD,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,uDAAuD;YACxF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,yBAAyB;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACK,WAAW,CACjB,KAAa,EACb,KAAa;QAEb,oDAAoD;QACpD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAEjE,qDAAqD;QACrD,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,4CAA4C;gBAC/D,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,kCAAkC;gBAC3D,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,qDAAqD;aAC/F,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACK,cAAc,CACpB,KAAa,EACb,QAAgB;QAEhB,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,8CAA8C;QAC9C,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBACrC,UAAU,IAAI,GAAG,CAAC;oBAClB,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,WAAW,IAAI,iBAAiB,KAAK,CAAC,EAAE,CAAC;oBAC5C,4DAA4D;oBAC5D,UAAU,GAAG,EAAE,CAAC;gBAClB,CAAC;gBACD,WAAW,GAAG,CAAC,WAAW,CAAC,CAAC,+BAA+B;gBAC3D,SAAS;YACX,CAAC;YAED,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;oBAC1B,UAAU,IAAI,IAAI,CAAC;oBACnB,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACtB,UAAU,GAAG,EAAE,CAAC;gBAChB,iBAAiB,GAAG,CAAC,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,iBAAiB,KAAK,CAAC,EAAE,CAAC;oBAC5B,UAAU,GAAG,EAAE,CAAC;gBAClB,CAAC;gBACD,iBAAiB,EAAE,CAAC;YACtB,CAAC;YAED,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC9B,UAAU,IAAI,IAAI,CAAC;oBACnB,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACtB,OAAO;oBACL,IAAI;oBACJ,WAAW,EAAE,CAAC,GAAG,CAAC;iBACnB,CAAC;YACJ,CAAC;YAED,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,CAAC,2BAA2B;IAC1C,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/utils/clingo-program-builder.d.ts

@@ -0,0 +1,39 @@
+/**
+    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 ClingoArgument, ClingoFactBuilder } from './clingo-fact-builder.js';
+export declare class ClingoProgramBuilder {
+    private rows;
+    /**
+     * Adds a new fact with a simple configuration.
+     * @param predicate - The fact's predicate
+     * @param args - The fact's arguments
+     */
+    addFact(predicate: string, ...args: ClingoArgument[]): ClingoProgramBuilder;
+    /**
+     * Adds a custom fact allowing use of the builder methods directly for more control.
+     * @param predicate - The fact's predicate
+     * @param configure - Function to configure the fact with builder methods
+     */
+    addCustomFact(predicate: string, configure: (builder: ClingoFactBuilder) => ClingoFactBuilder): ClingoProgramBuilder;
+    /**
+     * Adds an import to the clingo program
+     */
+    addImport(path: string): ClingoProgramBuilder;
+    /**
+     * Adds a comment
+     */
+    addComment(comment: string): ClingoProgramBuilder;
+    /**
+     * Builds all facts and returns them as a single string with each fact on a new line.
+     */
+    buildAll(): string;
+}

package/dist/utils/clingo-program-builder.js

@@ -0,0 +1,57 @@
+/**
+    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 { ClingoFactBuilder, } from './clingo-fact-builder.js';
+export class ClingoProgramBuilder {
+    rows = [];
+    /**
+     * Adds a new fact with a simple configuration.
+     * @param predicate - The fact's predicate
+     * @param args - The fact's arguments
+     */
+    addFact(predicate, ...args) {
+        const fact = new ClingoFactBuilder(predicate).addArguments(...args);
+        this.rows.push(fact);
+        return this;
+    }
+    /**
+     * Adds a custom fact allowing use of the builder methods directly for more control.
+     * @param predicate - The fact's predicate
+     * @param configure - Function to configure the fact with builder methods
+     */
+    addCustomFact(predicate, configure) {
+        const factBuilder = new ClingoFactBuilder(predicate);
+        // Allow configuration of the fact
+        this.rows.push(configure(factBuilder));
+        return this;
+    }
+    /**
+     * Adds an import to the clingo program
+     */
+    addImport(path) {
+        this.rows.push({ build: () => `#include "${path}".` });
+        return this;
+    }
+    /**
+     * Adds a comment
+     */
+    addComment(comment) {
+        this.rows.push({ build: () => `% ${comment}` });
+        return this;
+    }
+    /**
+     * Builds all facts and returns them as a single string with each fact on a new line.
+     */
+    buildAll() {
+        return this.rows.map((row) => row.build()).join('\n') + '\n';
+    }
+}
+//# sourceMappingURL=clingo-program-builder.js.map

package/dist/utils/clingo-program-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clingo-program-builder.js","sourceRoot":"","sources":["../../src/utils/clingo-program-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AACF,OAAO,EAEL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAMlC,MAAM,OAAO,oBAAoB;IACvB,IAAI,GAAe,EAAE,CAAC;IAE9B;;;;OAIG;IACH,OAAO,CAAC,SAAiB,EAAE,GAAG,IAAsB;QAClD,MAAM,IAAI,GAAG,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,aAAa,CACX,SAAiB,EACjB,SAA4D;QAE5D,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACrD,kCAAkC;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,CAAC;CACF"}

package/dist/utils/common-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+    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/>.
+*/
+/**
+ * Makes deep comparison between two objects.
+ * @param arg1 First object to compare.
+ * @param arg2 Second object to compare.
+ * @returns true, if objects are the same, false otherwise.
+ */
+export declare function deepCompare(arg1: object, arg2: object): boolean;
+/**
+ * Checks if string could be represented as BigInt.
+ * @param value String value
+ * @returns true, if 'value' can be represented as BigInt; false otherwise.
+ */
+export declare function isBigInt(value: string): boolean;

package/dist/utils/common-utils.js

@@ -0,0 +1,47 @@
+/**
+    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/>.
+*/
+/**
+ * Makes deep comparison between two objects.
+ * @param arg1 First object to compare.
+ * @param arg2 Second object to compare.
+ * @returns true, if objects are the same, false otherwise.
+ */
+export function deepCompare(arg1, arg2) {
+    if (Object.prototype.toString.call(arg1) ===
+        Object.prototype.toString.call(arg2)) {
+        if (Object.prototype.toString.call(arg1) === '[object Object]' ||
+            Object.prototype.toString.call(arg1) === '[object Array]') {
+            if (Object.keys(arg1).length !== Object.keys(arg2).length) {
+                return false;
+            }
+            return Object.keys(arg1).every(function (key) {
+                return deepCompare(arg1[key], arg2[key]);
+            });
+        }
+        return arg1 === arg2;
+    }
+    return false;
+}
+/**
+ * Checks if string could be represented as BigInt.
+ * @param value String value
+ * @returns true, if 'value' can be represented as BigInt; false otherwise.
+ */
+export function isBigInt(value) {
+    try {
+        return BigInt(parseInt(value, 10)) !== BigInt(value);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=common-utils.js.map

package/dist/utils/common-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-utils.js","sourceRoot":"","sources":["../../src/utils/common-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EACpC,CAAC;QACD,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,iBAAiB;YAC1D,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,gBAAgB,EACzD,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC1D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG;gBAC1C,OAAO,WAAW,CAChB,IAAI,CAAC,GAAwB,CAAC,EAC9B,IAAI,CAAC,GAAwB,CAAC,CAC/B,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,KAAK,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/constants.d.ts

@@ -0,0 +1,18 @@
+import type { PredefinedCardMetadata } from '../interfaces/project-interfaces.js';
+export declare const INT32_MAX = 2147483647;
+/**
+    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/>.
+*/
+/**
+ * These are names of the fields that are non-custom fields that present in metadata
+ */
+export declare const PREDEFINED_FIELDS: ("title" | "cardType" | "workflowState" | "rank" | "lastTransitioned" | "lastUpdated")[];
+export declare function isPredefinedField(value: string): value is keyof PredefinedCardMetadata;

package/dist/utils/constants.js

@@ -0,0 +1,27 @@
+export const INT32_MAX = 2147483647; // 2^31-1
+/**
+    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/>.
+*/
+/**
+ * These are names of the fields that are non-custom fields that present in metadata
+ */
+export const PREDEFINED_FIELDS = [
+    'rank',
+    'cardType',
+    'title',
+    'workflowState',
+    'lastUpdated',
+    'lastTransitioned',
+];
+export function isPredefinedField(value) {
+    return PREDEFINED_FIELDS.includes(value);
+}
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,SAAS;AAC9C;;;;;;;;;;EAUE;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,UAAU;IACV,OAAO;IACP,eAAe;IACf,aAAa;IACb,kBAAkB;CACwB,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAC/B,KAAa;IAEb,OAAQ,iBAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}