@cyberismo/data-handler 0.0.8 → 0.0.10

package/src/macros/scoreCard/index.ts

@@ -1,28 +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/>.
+  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 { createHtmlPlaceholder, validateMacroContent } from '../index.js';
+import { createImage, validateMacroContent } from '../index.js';
 
 import type { MacroGenerationContext } from '../../interfaces/macros.js';
 import macroMetadata from './metadata.js';
 import BaseMacro from '../base-macro.js';
 import type TaskQueue from '../task-queue.js';
+import { scoreCard } from '../../svg/index.js';
 
-export interface ScoreCardOptions extends MacroOptions {
-  title?: string;
+export interface ScoreCardOptions {
   value: number;
-  unit?: string;
   legend?: string;
+  title?: string;
+  unit?: string;
 }
 
 class ScoreCardMacro extends BaseMacro {
@@ -33,23 +35,17 @@ class ScoreCardMacro extends BaseMacro {
     this.validate(data);
   };
 
-  handleStatic = async (context: MacroGenerationContext, input: unknown) => {
-    const options = this.validate(input);
-    return this.createAsciidocElement(options);
-  };
-
-  handleInject = async (_: MacroGenerationContext, input: unknown) => {
+  handleStatic = async (_: MacroGenerationContext, input: unknown) => {
     const options = this.validate(input);
-    return createHtmlPlaceholder(this.metadata, options);
+    return createImage(
+      Buffer.from(scoreCard(options)).toString('base64'),
+      false,
+    );
   };
 
   private validate(input: unknown): ScoreCardOptions {
     return validateMacroContent<ScoreCardOptions>(this.metadata, input);
   }
-
-  private createAsciidocElement(options: ScoreCardOptions) {
-    return `\n----\n${options.title}: ${options.value} ${options.unit ?? ''} ${options.legend ?? ''}\n----\n`;
-  }
 }
 
 export default ScoreCardMacro;

package/src/macros/vega/index.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 { MacroGenerationContext } from '../../interfaces/macros.js';
+import BaseMacro from '../base-macro.js';
+import macroMetadata from './metadata.js';
+import type TaskQueue from '../task-queue.js';
+import {
+  createHtmlPlaceholder,
+  createImage,
+  validateMacroContent,
+} from '../index.js';
+import * as vega from 'vega';
+
+export interface VegaMacroInput {
+  spec: vega.Spec;
+}
+
+class VegaMacro extends BaseMacro {
+  constructor(tasksQueue: TaskQueue) {
+    super(macroMetadata, tasksQueue);
+  }
+
+  handleValidate = (input: unknown) => {
+    this.validate(input);
+  };
+
+  handleStatic = async (_: MacroGenerationContext, input: unknown) => {
+    const options = this.validate(input) as VegaMacroInput;
+    const view = new vega.View(vega.parse(options.spec), { renderer: 'none' });
+    const svg = await view.toSVG();
+    return createImage(Buffer.from(svg).toString('base64'), false);
+  };
+
+  handleInject = async (_: MacroGenerationContext, input: unknown) => {
+    const options = this.validate(input) as VegaMacroInput;
+    return createHtmlPlaceholder(this.metadata, options);
+  };
+
+  private validate(input: unknown): VegaMacroInput {
+    return validateMacroContent<VegaMacroInput>(this.metadata, input);
+  }
+}
+
+export default VegaMacro;

package/src/macros/vega/metadata.ts

@@ -0,0 +1,21 @@
+/**
+  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 type { MacroMetadata } from '../../interfaces/macros.js';
+
+const macroMetadata: MacroMetadata = {
+  name: 'vega',
+  tagName: 'vega',
+  schema: 'vegaMacroSchema',
+};
+
+export default macroMetadata;

package/src/macros/vegalite/index.ts

@@ -0,0 +1,46 @@
+/**
+  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 type { MacroGenerationContext } from '../../interfaces/macros.js';
+import BaseMacro from '../base-macro.js';
+import macroMetadata from './metadata.js';
+import type TaskQueue from '../task-queue.js';
+import * as vegaLite from 'vega-lite';
+import { createMacro, validateMacroContent } from '../index.js';
+
+export interface VegaLiteMacroInput {
+  spec: vegaLite.TopLevelSpec;
+}
+
+class VegaLiteMacro extends BaseMacro {
+  constructor(tasksQueue: TaskQueue) {
+    super(macroMetadata, tasksQueue);
+  }
+
+  handleValidate = (input: unknown) => {
+    this.validate(input);
+  };
+
+  handleStatic = async (_: MacroGenerationContext, input: unknown) => {
+    const options = this.validate(input) as VegaLiteMacroInput;
+    const compiled = vegaLite.compile(options.spec).spec;
+    return createMacro('vega', {
+      spec: compiled,
+    });
+  };
+
+  private validate(input: unknown): VegaLiteMacroInput {
+    return validateMacroContent<VegaLiteMacroInput>(this.metadata, input);
+  }
+}
+
+export default VegaLiteMacro;

package/src/macros/vegalite/metadata.ts

@@ -0,0 +1,21 @@
+/**
+  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 type { MacroMetadata } from '../../interfaces/macros.js';
+
+const macroMetadata: MacroMetadata = {
+  name: 'vegaLite',
+  tagName: 'vegaLite',
+  schema: 'vegaLiteMacroSchema',
+};
+
+export default macroMetadata;

package/src/macros/xref/index.ts

@@ -0,0 +1,73 @@
+/**
+  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 { validateMacroContent } from '../index.js';
+
+import type { MacroGenerationContext } from '../../interfaces/macros.js';
+import macroMetadata from './metadata.js';
+import BaseMacro from '../base-macro.js';
+import type TaskQueue from '../task-queue.js';
+
+export interface XrefMacroOptions {
+  cardKey: string;
+}
+
+export default class XrefMacro extends BaseMacro {
+  constructor(tasksQueue: TaskQueue) {
+    super(macroMetadata, tasksQueue);
+  }
+
+  handleValidate = (input: unknown) => {
+    this.validate(input);
+  };
+
+  handleStatic = async (
+    context: MacroGenerationContext,
+    input: unknown,
+  ): Promise<string> => {
+    const options = this.validate(input);
+    const card = await this.getCard(options.cardKey, context);
+
+    if (!card || !card.metadata) {
+      throw new Error(`Card key ${options.cardKey} not found`);
+    }
+
+    // in static mode we need to use internal references
+    return `<<${options.cardKey}>>`;
+  };
+
+  handleInject = async (context: MacroGenerationContext, input: unknown) => {
+    const options = this.validate(input);
+    const card = await this.getCard(options.cardKey, context);
+
+    if (!card || !card.metadata) {
+      throw new Error(`Card key ${options.cardKey} not found`);
+    }
+
+    return `xref:${options.cardKey}.adoc[${card.metadata.title}]`;
+  };
+
+  private async getCard(cardKey: string, context: MacroGenerationContext) {
+    const card = await context.project.cardDetailsById(cardKey, {
+      metadata: true,
+    });
+    if (!card || !card.metadata) {
+      throw new Error(`Card key ${cardKey} not found`);
+    }
+    return card;
+  }
+
+  private validate(input: unknown): XrefMacroOptions {
+    return validateMacroContent<XrefMacroOptions>(this.metadata, input);
+  }
+}

package/src/macros/xref/metadata.ts

@@ -0,0 +1,22 @@
+/**
+  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 type { MacroMetadata } from '../../interfaces/macros.js';
+
+const macroMetadata: MacroMetadata = {
+  name: 'xref',
+  tagName: 'xref',
+  schema: 'xrefMacroSchema',
+};
+
+export default macroMetadata;

package/src/module-manager.ts

@@ -31,9 +31,6 @@ import { Validate } from './commands/index.js';
 const FILE_PROTOCOL = 'file:';
 const HTTPS_PROTOCOL = 'https:';
 
-// timeout in milliseconds for git client (no stdout / stderr activity)
-const DEFAULT_TIMEOUT = 10000;
-
 // When dependencies are built to a map, use map that has
 //   key: module name,
 //   value: list of unique prefixes
@@ -144,7 +141,7 @@ export class ModuleManager {
 
       const git: SimpleGit = simpleGit({
         timeout: {
-          block: DEFAULT_TIMEOUT,
+          block: this.gitTimeout(),
         },
       });
 
@@ -201,7 +198,7 @@ export class ModuleManager {
       if (pathExists(destinationPath)) {
         const git: SimpleGit = simpleGit({
           timeout: {
-            block: DEFAULT_TIMEOUT,
+            block: this.gitTimeout(),
           },
         });
         const options = ['--abbrev-ref', 'HEAD'];
@@ -231,6 +228,19 @@ export class ModuleManager {
       : new Set();
   }
 
+  // Increase timeout for CI environments and add platform-specific adjustments
+  private gitTimeout(): number {
+    const baseTimeout = 15000;
+    const isCI = process.env.CI;
+    const isWindows = process.platform === 'win32';
+
+    let timeout = baseTimeout;
+    if (isCI) timeout *= 2; // Double timeout in CI
+    if (isWindows) timeout *= 1.5; // 50% more time on Windows
+
+    return timeout;
+  }
+
   // Collects one module's dependency prefixes to 'this.modules'.
   // Note that there can be duplicate entries.
   private async doCollectModulePrefix(

package/src/permissions/action-guard.ts

@@ -10,7 +10,7 @@
     License along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-import type { Calculate } from '../commands/index.js';
+import type { CalculationEngine } from '../containers/project/calculation-engine.js';
 import type { DeniedOperationCollection } from '../types/queries.js';
 
 export type Action = keyof DeniedOperationCollection;
@@ -25,7 +25,7 @@ function checkOperation<T extends { errorMessage: string }>(data: Array<T>) {
  * This class is used to guard actions from being used without permissions
  */
 export class ActionGuard {
-  constructor(private calculate: Calculate) {}
+  constructor(private calculate: CalculationEngine) {}
 
   /**
    * Checks whether an action can be done
@@ -39,7 +39,7 @@ export class ActionGuard {
     param?: string,
   ) {
     await this.calculate.generate();
-    const cards = await this.calculate.runQuery('card', {
+    const cards = await this.calculate.runQuery('card', 'localApp', {
       cardKey,
     });
     if (cards.length === 0) {

package/src/resources/card-type-resource.ts

@@ -153,6 +153,50 @@ export class CardTypeResource extends FileResource {
     }
   }
 
+  // Apply state mapping to all cards using this card type.
+  // Checks that all states in the current workflow are updated.
+  private async handleWorkflowChange<Type>(
+    stateMapping: Record<string, string>,
+    op: ChangeOperation<Type>,
+  ) {
+    await this.verifyStateMapping(stateMapping, op);
+    const cards = await this.collectCards(
+      {
+        metadata: true,
+        content: true,
+      },
+      this.content.name,
+    );
+
+    const unmappedStates: string[] = [];
+
+    // Update each card's workflowState if it has a mapping
+    const updatePromises = cards.map(async (card) => {
+      if (card.metadata && card.metadata.workflowState) {
+        const currentState = card.metadata.workflowState as string;
+        const newState = stateMapping[currentState];
+
+        if (newState && newState !== currentState) {
+          this.logger.info(
+            `Updating card '${card.key}': ${currentState} -> ${newState}`,
+          );
+          card.metadata.workflowState = newState;
+          await this.project.updateCardMetadata(card, card.metadata);
+        } else if (!newState && !unmappedStates.includes(currentState)) {
+          unmappedStates.push(currentState);
+        }
+      }
+    });
+
+    await Promise.all(updatePromises);
+
+    if (unmappedStates.length > 0) {
+      this.logger.warn(
+        `Found unmapped states that were not updated: ${unmappedStates.join(', ')}`,
+      );
+    }
+  }
+
   // Checks if field type exists in this card type.
   private async hasFieldType(field: Partial<CustomField>): Promise<boolean> {
     return this.data.customFields.some((item) => item.name === field.name);
@@ -315,6 +359,57 @@ export class CardTypeResource extends FileResource {
     }
   }
 
+  // Verifies that:
+  // - all states in the current workflow are covered in the state mapping
+  // - the states are correct
+  private async verifyStateMapping<Type>(
+    stateMapping: Record<string, string>,
+    op: ChangeOperation<Type>,
+  ) {
+    const currentWorkflowName = op.target as string;
+    const currentWorkflow =
+      await this.project.resource<Workflow>(currentWorkflowName);
+    if (!currentWorkflow) {
+      throw new Error(
+        `Workflow '${currentWorkflowName}' does not exist in the project`,
+      );
+    }
+
+    const newWorkflow = await this.project.resource<Workflow>(op.to as string);
+    if (!newWorkflow) {
+      throw new Error(`Workflow '${op.to}' does not exist in the project`);
+    }
+
+    const currentWorkflowStates = currentWorkflow.states.map(
+      (state) => state.name,
+    );
+    const mappedSourceStates = Object.keys(stateMapping);
+    const unmappedCurrentStates = currentWorkflowStates.filter(
+      (stateName) => !mappedSourceStates.includes(stateName),
+    );
+
+    if (unmappedCurrentStates.length > 0) {
+      throw new Error(
+        `State mapping validation failed: The following states exist in the current workflow '${currentWorkflowName}' ` +
+          `but are not mapped from in the state mapping JSON file: ${unmappedCurrentStates.join(', ')}. ` +
+          `Please ensure all states in the current workflow are accounted for in the mapping to ensure all cards are properly updated.`,
+      );
+    }
+
+    // Also verify that all target states exist in the new workflow
+    const newWorkflowStates = newWorkflow.states.map((state) => state.name);
+    const mappedTargetStates = Object.values(stateMapping);
+    const invalidTargetStates = mappedTargetStates.filter(
+      (stateName) => !newWorkflowStates.includes(stateName),
+    );
+
+    if (invalidTargetStates.length > 0) {
+      throw new Error(
+        `State mapping validation failed: The following target states in the mapping do not exist in the new workflow '${op.to}': ${invalidTargetStates.join(', ')}.`,
+      );
+    }
+  }
+
   /**
    * Creates a new card type object. Base class writes the object to disk automatically.
    * @param workflowName Workflow name that this card type uses.
@@ -404,7 +499,12 @@ export class CardTypeResource extends FileResource {
         content.optionallyVisibleFields as Type[],
       ) as string[];
     } else if (key === 'workflow') {
+      const changeOp = op as ChangeOperation<string>;
+      const stateMapping = changeOp.mappingTable?.stateMapping || {};
       content.workflow = super.handleScalar(op) as string;
+      if (Object.keys(stateMapping).length > 0) {
+        await this.handleWorkflowChange(stateMapping, changeOp);
+      }
     } else if (key === 'customFields') {
       await this.validateFieldType(key, op);
       content.customFields = super.handleArray(

package/src/resources/file-resource.ts

@@ -137,6 +137,16 @@ export class FileResource extends ResourceObject {
     return cards;
   }
 
+  // Get (resource folder) type name
+  protected get getType() {
+    return super.getType;
+  }
+
+  // Get logger instance
+  protected get logger() {
+    return super.getLogger(this.getType);
+  }
+
   // Initialize the resource.
   protected initialize() {
     if (this.resourceName.type === '') {
@@ -301,9 +311,9 @@ export class FileResource extends ResourceObject {
   ) {
     function toValue(op: Operation<Type>) {
       if (op.name === 'rank') return op.newIndex;
-      if (op.name === 'add') return op.target;
-      if (op.name === 'remove') return op.target;
-      if (op.name === 'change') return op.to;
+      if (op.name === 'add') return JSON.stringify(op.target);
+      if (op.name === 'remove') return JSON.stringify(op.target);
+      if (op.name === 'change') return JSON.stringify(op.to);
     }
 
     // Check that new name is valid.
@@ -320,7 +330,9 @@ export class FileResource extends ResourceObject {
     } catch (error) {
       if (error instanceof Error) {
         const errorValue = typeof op === 'object' ? toValue(op) : op;
-        throw new Error(`Cannot ${op.name} '${key}' --> '${errorValue}'`);
+        throw new Error(
+          `Cannot ${op.name} '${key}' --> '${errorValue}: ${error.message}'`,
+        );
       }
     }
 

package/src/resources/folder-resource.ts

@@ -11,8 +11,10 @@
   License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 
-import { basename, join } from 'node:path';
-import { mkdir, rename, rm } from 'node:fs/promises';
+import { basename, dirname, join, normalize } from 'node:path';
+import { mkdir, readdir, readFile, rename, rm } from 'node:fs/promises';
+
+import { writeFileSafe } from '../utils/file-utils.js';
 
 import type { ResourceFolderType } from '../interfaces/project-interfaces.js';
 import {
@@ -27,6 +29,7 @@ import {
   sortCards,
 } from './file-resource.js';
 import type { ResourceContent } from '../interfaces/resource-interfaces.js';
+import { VALID_FOLDER_RESOURCE_FILES } from '../utils/constants.js';
 
 export {
   type Card,
@@ -73,6 +76,15 @@ export class FolderResource extends FileResource {
     await rm(this.internalFolder, { recursive: true, force: true });
   }
 
+  // Get (resource folder) type name
+  protected get getType() {
+    return super.getType;
+  }
+
+  protected get logger() {
+    return super.getLogger(this.getType);
+  }
+
   protected initialize(): void {
     super.initialize();
 
@@ -98,6 +110,51 @@ export class FolderResource extends FileResource {
     return super.show();
   }
 
+  /**
+   * Shows the content of a file in the resource.
+   * @param fileName Name of the file to show.
+   * @returns the content of the file.
+   */
+  public async showFile(fileName: string): Promise<string> {
+    const filePath = join(this.internalFolder, fileName);
+    return readFile(filePath, 'utf8');
+  }
+
+  /**
+   * Shows all file names in the resource.
+   * @returns all file names in the resource.
+   */
+  public async showFileNames(): Promise<string[]> {
+    const files = await readdir(this.internalFolder);
+    return files.filter((file) => VALID_FOLDER_RESOURCE_FILES.includes(file));
+  }
+
+  /**
+   * Updates a file in the resource.
+   * @param fileName The name of the file to update.
+   * @param changedContent The new content for the file.
+   */
+  public async updateFile(fileName: string, changedContent: string) {
+    const filePath = join(this.internalFolder, fileName);
+
+    // Do not allow updating file in other directories
+    const normalizedFilePath = normalize(filePath);
+    const normalizedInternalFilePath = normalize(this.internalFolder);
+    if (dirname(normalizedFilePath) !== normalizedInternalFilePath) {
+      throw new Error(`File '${fileName}' is not in the resource`);
+    }
+
+    // This makes sure that the file is in the resource folder.
+    if (basename(normalizedFilePath) !== fileName) {
+      throw new Error(`File '${fileName}' is not in the resource`);
+    }
+    // check if the file is whitelisted
+    if (!VALID_FOLDER_RESOURCE_FILES.includes(fileName)) {
+      throw new Error(`File '${fileName}' is not whitelisted`);
+    }
+
+    await writeFileSafe(filePath, changedContent, { flag: 'w' });
+  }
   /**
    * Updates resource.
    * @param key Key to modify

package/src/resources/graph-model-resource.ts

@@ -150,7 +150,7 @@ export class GraphModelResource extends FolderResource {
 
     await super.update(key, op);
 
-    const content = { ...(this.content as GraphModel) };
+    const content = structuredClone(this.content) as GraphModel;
 
     if (key === 'name') {
       content.name = super.handleScalar(op) as string;

package/src/resources/graph-view-resource.ts

@@ -144,7 +144,7 @@ export class GraphViewResource extends FolderResource {
 
     await super.update(key, op);
 
-    const content = { ...(this.content as GraphView) };
+    const content = structuredClone(this.content) as GraphView;
 
     if (key === 'name') {
       content.name = super.handleScalar(op) as string;

package/src/resources/report-resource.ts

@@ -179,7 +179,7 @@ export class ReportResource extends FolderResource {
 
     await super.update(key, op);
 
-    const content = { ...(this.content as ReportMetadata) };
+    const content = structuredClone(this.content) as ReportMetadata;
 
     if (key === 'name') {
       content.name = super.handleScalar(op) as string;