@cyberismo/data-handler 0.0.2

package/dist/macros/index.js

@@ -0,0 +1,237 @@
+/**
+    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 Handlebars from 'handlebars';
+import createCards from './createCards/index.js';
+import graph from './graph/index.js';
+import report from './report/index.js';
+import scoreCard from './scoreCard/index.js';
+import { validateJson } from '../utils/validate.js';
+import { DHValidationError } from '../exceptions/index.js';
+import TaskQueue from './task-queue.js';
+const CURLY_LEFT = '&#123;';
+const CURLY_RIGHT = '&#125;';
+export const macros = {
+    createCards,
+    graph,
+    report,
+    scoreCard,
+};
+export function validateMacroContent(macro, data, validator) {
+    if (!macro.schema) {
+        throw new Error(`Macro ${macro.name} does not have a schema`);
+    }
+    try {
+        return validateJson(data, {
+            schemaId: macro.schema,
+            validator,
+        });
+    }
+    catch (error) {
+        let message = `Error: ${error instanceof Error ? error.message : 'Unknown error'}`;
+        if (error instanceof DHValidationError) {
+            message = `${error.errors?.map((e) => e.message).join(', ')}`;
+        }
+        throw new Error(`${macro.name} macro JSON validation error: ${message}`);
+    }
+}
+/**
+ * Registers the macros with Handlebars
+ * @param {Mode} mode - The mode to register the macros in
+ */
+export function registerMacros(instance, context, tasks) {
+    const macroInstances = [];
+    for (const macro of Object.keys(macros)) {
+        const MacroClass = macros[macro];
+        const macroInstance = new MacroClass(tasks);
+        instance.registerHelper(macro, function (options) {
+            if (this != null &&
+                typeof this === 'object' &&
+                '__isRaw' in this &&
+                this.__isRaw) {
+                // we use escaped chars so that they will not be re-run
+                return `${CURLY_LEFT}${CURLY_LEFT}#${macro}${CURLY_RIGHT}${CURLY_RIGHT}${options.fn(this)}${CURLY_LEFT}${CURLY_LEFT}/${macro}${CURLY_RIGHT}${CURLY_RIGHT}`;
+            }
+            return macroInstance.invokeMacro(context, options);
+        });
+        macroInstances.push(macroInstance);
+    }
+    instance.registerHelper('raw', function (options) {
+        return options.fn({
+            __isRaw: true,
+        });
+    });
+    return macroInstances;
+}
+/**
+ * Calculate amount of handlebars templates inside a string
+ * @param input
+ */
+export function macroCount(input) {
+    const regex = /{{#[\w\s-]+?}}/g;
+    const match = input.match(regex);
+    return match ? match.length : 0;
+}
+/**
+ * Registers macros as handlebars helpers, which just leaves the macros in the content
+ * Can be used when your macro uses handlebars and handles content that might contain macros
+ * The handleMacros function will handle recursive macros so do not execute them inside your macro
+ * @param instance handlebars instance
+ */
+export function registerEmptyMacros(instance) {
+    for (const macro of Object.keys(macros)) {
+        instance.registerHelper(macro, function (options) {
+            return `{{#${macro}}}${options.fn(this)}{{/${macro}}}`;
+        });
+    }
+}
+/**
+ * Handle the macros in the content
+ * @param content - The content to handle the macros in
+ * @param mode - The mode to handle the macros in. Inject mode will generate injectable placeholders for the macros while static mode will generate valid adoc. Validate mode will only validate the macros syntax and throw errors in case of issues.
+ */
+export async function evaluateMacros(content, context, maxTries = 10) {
+    const handlebars = Handlebars.create();
+    const tasks = new TaskQueue();
+    registerMacros(handlebars, context, tasks);
+    let result = content;
+    while (maxTries-- > 0) {
+        tasks.reset();
+        const compiled = handlebars.compile(result, {
+            strict: true,
+        });
+        try {
+            result = compiled({});
+            await tasks.waitAll();
+            result = applyMacroResults(result, tasks, context);
+            if (macroCount(result) === 0) {
+                break;
+            }
+        }
+        catch (err) {
+            // This will produce a warning in the output in inject/static modes and throw an error in validate mode
+            return handleMacroError(err, '', context);
+        }
+    }
+    if (macroCount(result) !== 0) {
+        return handleMacroError(new Error(`Too many recursive macro evaluations.`), '', context);
+    }
+    return result.replaceAll(CURLY_LEFT, '{').replaceAll(CURLY_RIGHT, '}');
+}
+/**
+ * This function assumes that tasks, which were started by macros, are complete.
+ * It replaces the placeholders of the tasks with the actual results
+ * @param input Adoc content, which might have macro placeholders
+ * @param tasks The taskqueue, which was used to run the macros
+ * @param context General context for the macro evaluation process
+ * @returns Adoc, where placeholders have been replaced with the results.
+ * Note that the results might include new macros.
+ */
+export function applyMacroResults(input, tasks, context) {
+    for (const item of tasks) {
+        if (item.promiseResult === null) {
+            input = handleMacroError(new Error(`Tried to access result before it was resolved for ${item.placeholder}`), item.macro, context);
+        }
+        else {
+            input = input.replace(item.placeholder, item.promiseResult);
+        }
+    }
+    return input;
+}
+/**
+ * Handles errors that come when handling macros
+ * @param error - The error that was thrown
+ * @param macro - The macro that caused the error
+ * @returns The error message that is valid adoc
+ */
+export function handleMacroError(error, macro, context) {
+    let message = `Error: ${error instanceof Error ? error.message : 'Unknown error'}`;
+    if (error instanceof DHValidationError) {
+        message = `Check json syntax of macro ${macro}: ${error.errors?.map((e) => e.message).join(', ')}`;
+    }
+    if (typeof error === 'object' &&
+        error != null &&
+        'lineNumber' in error &&
+        typeof error.lineNumber === 'number') {
+        message += ` at line ${error.lineNumber}`;
+    }
+    if (context.mode === 'validate') {
+        throw new Error(message);
+    }
+    else {
+        return createAdmonition('WARNING', 'Macro Error', message);
+    }
+}
+// This is used to generate unique keys for macros
+// There might be a better way to do this
+let macroCounter = 0;
+/**
+ * Creates an injectable placeholder for a macro
+ * @param macro - The macro to create the placeholder for
+ * @param options - Options will be passed to the html element as attributes
+ */
+export function createHtmlPlaceholder(macro, options) {
+    // Flatten nested objects into dot notation attributes
+    const flattenedOptions = {};
+    // Helper function to flatten nested objects
+    const flatten = (obj, prefix = '') => {
+        Object.entries(obj).forEach(([key, value]) => {
+            const newKey = prefix ? `${prefix}.${key}` : key;
+            if (value !== null &&
+                typeof value === 'object' &&
+                !Array.isArray(value)) {
+                // Recursively flatten nested objects
+                flatten(value, newKey);
+            }
+            else {
+                // Add leaf values to flattened options
+                flattenedOptions[newKey] = value;
+            }
+        });
+    };
+    flatten(options);
+    // Convert flattened options to attribute strings
+    const attributeStrings = Object.entries(flattenedOptions)
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => `${key}="${value}"`);
+    const optionString = attributeStrings.join(' ');
+    // start with a line change to ensure that inline passthrough +++ is on its own line
+    return `\n+++\n<${macro.tagName}${optionString ? ` ${optionString}` : ''} key="macro-${macroCounter++}"></${macro.tagName}>\n+++\n`;
+}
+/**
+ * Creates an adoc admonition
+ * @param type - The type of admonition
+ * @param label - The label of the admonition
+ * @param content - The content of the admonition
+ * @returns The adoc admonition as a string
+ */
+export function createAdmonition(type, label, content) {
+    return `[${type}]\n.${label}\n====\n${content}\n====\n\n`;
+}
+/**
+ * Helper function for including base64 encoded images for now
+ * @param image base64 encoded image
+ * @returns valid asciidoc with the image
+ */
+export function createImage(image) {
+    if (process.env.EXPORT_FORMAT) {
+        return `image::data:image/svg+xml;base64,${image}[]\n`;
+    }
+    else {
+        return `++++
+<div class="cyberismo-svg-wrapper" data-type="cyberismo-svg-wrapper">
+${Buffer.from(image, 'base64').toString('utf-8')}
+</div>
+++++
+`;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/macros/index.js.map

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

package/dist/macros/report/index.d.ts

@@ -0,0 +1,26 @@
+/**
+    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 { MacroOptions } from '../index.js';
+import type { MacroGenerationContext } from '../../interfaces/macros.js';
+import BaseMacro from '../base-macro.js';
+import type TaskQueue from '../task-queue.js';
+export interface ReportOptions extends MacroOptions {
+    name: string;
+}
+declare class ReportMacro extends BaseMacro {
+    constructor(tasksQueue: TaskQueue);
+    handleValidate: (input: unknown) => void;
+    handleStatic: (context: MacroGenerationContext, data: unknown) => Promise<string>;
+    handleInject: (context: MacroGenerationContext, data: unknown) => Promise<string>;
+    private validate;
+}
+export default ReportMacro;

package/dist/macros/report/index.js

@@ -0,0 +1,70 @@
+/**
+    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 { registerEmptyMacros, validateMacroContent } from '../index.js';
+import macroMetadata from './metadata.js';
+import { Project } from '../../containers/project.js';
+import { Calculate } from '../../commands/index.js';
+import Handlebars from 'handlebars';
+import BaseMacro from '../base-macro.js';
+import { validateJson } from '../../utils/validate.js';
+import { ReportResource } from '../../resources/report-resource.js';
+import { resourceName } from '../../utils/resource-utils.js';
+class ReportMacro extends BaseMacro {
+    constructor(tasksQueue) {
+        super(macroMetadata, tasksQueue);
+    }
+    handleValidate = (input) => {
+        this.validate(input);
+    };
+    handleStatic = async (context, data) => {
+        return this.handleInject(context, data);
+    };
+    handleInject = async (context, data) => {
+        const options = this.validate(data);
+        const project = new Project(context.projectPath);
+        const resource = new ReportResource(project, resourceName(options.name));
+        const report = await resource.show();
+        if (!report)
+            throw new Error(`Report ${options} does not exist`);
+        if (report.schema) {
+            validateJson(options, {
+                schema: report.schema,
+            });
+        }
+        const handlebarsContext = {
+            cardKey: context.cardKey,
+            ...options,
+        };
+        const handlebars = Handlebars.create();
+        const template = handlebars.compile(report.queryTemplate, {
+            strict: true,
+        });
+        const calculate = new Calculate(project);
+        const result = await calculate.runLogicProgram({
+            query: template(handlebarsContext),
+        });
+        if (result.error) {
+            throw new Error(result.error);
+        }
+        // register empty macros so that other macros aren't touched yet
+        registerEmptyMacros(handlebars);
+        return handlebars.compile(report.contentTemplate)({
+            ...handlebarsContext,
+            ...result,
+        });
+    };
+    validate(data) {
+        return validateMacroContent(this.metadata, data);
+    }
+}
+export default ReportMacro;
+//# sourceMappingURL=index.js.map

package/dist/macros/report/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/macros/report/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,aAAa,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,SAAS,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAM7D,MAAM,WAAY,SAAQ,SAAS;IACjC,YAAY,UAAqB;QAC/B,KAAK,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC;IACD,cAAc,GAAG,CAAC,KAAc,EAAE,EAAE;QAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,YAAY,GAAG,KAAK,EAAE,OAA+B,EAAE,IAAa,EAAE,EAAE;QACtE,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,YAAY,GAAG,KAAK,EAAE,OAA+B,EAAE,IAAa,EAAE,EAAE;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAErC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,iBAAiB,CAAC,CAAC;QAEjE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,YAAY,CAAC,OAAO,EAAE;gBACpB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,iBAAiB,GAAG;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,OAAO;SACX,CAAC;QAEF,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAEvC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE;YACxD,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC;YAC7C,KAAK,EAAE,QAAQ,CAAC,iBAAiB,CAAC;SACnC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,gEAAgE;QAChE,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAEhC,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAChD,GAAG,iBAAiB;YACpB,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC,CAAC;IAEM,QAAQ,CAAC,IAAa;QAC5B,OAAO,oBAAoB,CAAgB,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}

package/dist/macros/report/metadata.d.ts

@@ -0,0 +1,14 @@
+/**
+    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 { MacroMetadata } from '../../interfaces/macros.js';
+declare const macroMetadata: MacroMetadata;
+export default macroMetadata;

package/dist/macros/report/metadata.js

@@ -0,0 +1,18 @@
+/**
+    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/>.
+*/
+const macroMetadata = {
+    name: 'report',
+    tagName: 'report',
+    schema: 'reportMacroBaseSchema',
+};
+export default macroMetadata;
+//# sourceMappingURL=metadata.js.map

package/dist/macros/report/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/macros/report/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,aAAa,GAAkB;IACnC,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,uBAAuB;CAChC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/macros/scoreCard/index.d.ts

@@ -0,0 +1,30 @@
+/**
+    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 { MacroOptions } from '../index.js';
+import type { MacroGenerationContext } from '../../interfaces/macros.js';
+import BaseMacro from '../base-macro.js';
+import type TaskQueue from '../task-queue.js';
+export interface ScoreCardOptions extends MacroOptions {
+    title?: string;
+    value: number;
+    unit?: string;
+    legend?: string;
+}
+declare class ScoreCardMacro extends BaseMacro {
+    constructor(tasksQueue: TaskQueue);
+    handleValidate: (data: string) => void;
+    handleStatic: (context: MacroGenerationContext, input: unknown) => Promise<string>;
+    handleInject: (_: MacroGenerationContext, input: unknown) => Promise<string>;
+    private validate;
+    private createAsciidocElement;
+}
+export default ScoreCardMacro;

package/dist/macros/scoreCard/index.js

@@ -0,0 +1,38 @@
+/**
+    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 { createHtmlPlaceholder, validateMacroContent } from '../index.js';
+import macroMetadata from './metadata.js';
+import BaseMacro from '../base-macro.js';
+class ScoreCardMacro extends BaseMacro {
+    constructor(tasksQueue) {
+        super(macroMetadata, tasksQueue);
+    }
+    handleValidate = (data) => {
+        this.validate(data);
+    };
+    handleStatic = async (context, input) => {
+        const options = this.validate(input);
+        return this.createAsciidocElement(options);
+    };
+    handleInject = async (_, input) => {
+        const options = this.validate(input);
+        return createHtmlPlaceholder(this.metadata, options);
+    };
+    validate(input) {
+        return validateMacroContent(this.metadata, input);
+    }
+    createAsciidocElement(options) {
+        return `\n----\n${options.title}: ${options.value} ${options.unit ?? ''} ${options.legend ?? ''}\n----\n`;
+    }
+}
+export default ScoreCardMacro;
+//# sourceMappingURL=index.js.map

package/dist/macros/scoreCard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/macros/scoreCard/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAGF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,aAAa,MAAM,eAAe,CAAC;AAC1C,OAAO,SAAS,MAAM,kBAAkB,CAAC;AAUzC,MAAM,cAAe,SAAQ,SAAS;IACpC,YAAY,UAAqB;QAC/B,KAAK,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC;IACD,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,YAAY,GAAG,KAAK,EAAE,OAA+B,EAAE,KAAc,EAAE,EAAE;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,YAAY,GAAG,KAAK,EAAE,CAAyB,EAAE,KAAc,EAAE,EAAE;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC,CAAC;IAEM,QAAQ,CAAC,KAAc;QAC7B,OAAO,oBAAoB,CAAmB,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IAEO,qBAAqB,CAAC,OAAyB;QACrD,OAAO,WAAW,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,UAAU,CAAC;IAC5G,CAAC;CACF;AAED,eAAe,cAAc,CAAC"}

package/dist/macros/scoreCard/metadata.d.ts

@@ -0,0 +1,14 @@
+/**
+    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 { MacroMetadata } from '../../interfaces/macros.js';
+declare const macroMetadata: MacroMetadata;
+export default macroMetadata;

package/dist/macros/scoreCard/metadata.js

@@ -0,0 +1,18 @@
+/**
+    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/>.
+*/
+const macroMetadata = {
+    name: 'scoreCard',
+    tagName: 'score-card',
+    schema: 'scoreCardMacroSchema',
+};
+export default macroMetadata;
+//# sourceMappingURL=metadata.js.map

package/dist/macros/scoreCard/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/macros/scoreCard/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,aAAa,GAAkB;IACnC,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,sBAAsB;CAC/B,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/macros/task-queue.d.ts

@@ -0,0 +1,46 @@
+/**
+    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 { MacroTaskState } from '../interfaces/macros.js';
+export default class TaskQueue {
+    private tasks;
+    /**
+     * Pushes a task to the task queue
+     * @param task The task to push
+     */
+    push(task: MacroTaskState): void;
+    /**
+     * Finds an existing task based on its id
+     * @param globalId unique id across both macro classes and instances
+     * @param localId Id within the instance
+     * @returns task if found else undefined
+     */
+    find(globalId: string, localId: number): MacroTaskState | undefined;
+    /**
+     * Waits for all tasks to be done
+     */
+    waitAll(): Promise<void>;
+    /**
+     * Waits for a single task to be done
+     * @param task task to wait
+     */
+    waitTask(task: MacroTaskState): Promise<void>;
+    /**
+     * Removes all tasks. If they are running, they continue to run because they are promises
+     */
+    reset(): Promise<void>;
+    /**
+     * When iterating over task queue, it'll return each task
+     */
+    [Symbol.iterator](): {
+        next(): IteratorResult<MacroTaskState>;
+    };
+}

package/dist/macros/task-queue.js

@@ -0,0 +1,69 @@
+/**
+    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/>.
+*/
+export default class TaskQueue {
+    tasks = [];
+    /**
+     * Pushes a task to the task queue
+     * @param task The task to push
+     */
+    push(task) {
+        this.tasks.push(task);
+    }
+    /**
+     * Finds an existing task based on its id
+     * @param globalId unique id across both macro classes and instances
+     * @param localId Id within the instance
+     * @returns task if found else undefined
+     */
+    find(globalId, localId) {
+        return this.tasks.find((task) => task.globalId === globalId && task.localId === localId);
+    }
+    /**
+     * Waits for all tasks to be done
+     */
+    async waitAll() {
+        for (const task of this.tasks) {
+            await task.promise;
+        }
+    }
+    /**
+     * Waits for a single task to be done
+     * @param task task to wait
+     */
+    async waitTask(task) {
+        await task.promise;
+    }
+    /**
+     * Removes all tasks. If they are running, they continue to run because they are promises
+     */
+    async reset() {
+        this.tasks = [];
+    }
+    /**
+     * When iterating over task queue, it'll return each task
+     */
+    [Symbol.iterator]() {
+        let index = 0;
+        const tasks = this.tasks;
+        return {
+            next() {
+                if (index < tasks.length) {
+                    return { value: tasks[index++], done: false };
+                }
+                else {
+                    return { value: undefined, done: true };
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=task-queue.js.map

package/dist/macros/task-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue.js","sourceRoot":"","sources":["../../src/macros/task-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,OAAO,OAAO,SAAS;IACpB,KAAK,GAAqB,EAAE,CAAC;IAErC;;;OAGG;IACI,IAAI,CAAC,IAAoB;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACI,IAAI,CAAC,QAAgB,EAAE,OAAe;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CACjE,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ,CAAC,IAAoB;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,OAAO;YACL,IAAI;gBACF,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;oBACzB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;gBAChD,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC1C,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}