@twin.org/node-core 0.0.2-next.26 → 0.0.2-next.27

package/dist/esm/index.mjs

@@ -1,2508 +0,0 @@
-import { PasswordHelper } from '@twin.org/api-auth-entity-storage-service';
-import { I18n, Is, Converter, GeneralError, BaseError, Coerce, RandomHelper, Urn, EnvHelper } from '@twin.org/core';
-import { Sha256, PasswordGenerator, Bip39 } from '@twin.org/crypto';
-import { AuthenticationComponentType, InformationComponentType, RestRouteProcessorType, SocketRouteProcessorType, AuthenticationAdminComponentType } from '@twin.org/engine-server-types';
-import { WalletConnectorType, IdentityConnectorType, EntityStorageConnectorType, BlobStorageConnectorType, BlobStorageComponentType, VaultConnectorType, DltConfigType, LoggingConnectorType, LoggingComponentType, BackgroundTaskConnectorType, TaskSchedulerComponentType, EventBusConnectorType, EventBusComponentType, TelemetryConnectorType, TelemetryComponentType, MessagingEmailConnectorType, MessagingSmsConnectorType, MessagingPushNotificationConnectorType, MessagingAdminComponentType, MessagingComponentType, FaucetConnectorType, EngineTypeHelper, NftConnectorType, NftComponentType, VerifiableStorageConnectorType, VerifiableStorageComponentType, ImmutableProofComponentType, IdentityComponentType, IdentityResolverConnectorType, IdentityResolverComponentType, IdentityProfileConnectorType, IdentityProfileComponentType, AttestationConnectorType, AttestationComponentType, DataProcessingComponentType, DataConverterConnectorType, DataExtractorConnectorType, AuditableItemGraphComponentType, AuditableItemStreamComponentType, DocumentManagementComponentType, AuthenticationGeneratorComponentType, RightsManagementPapComponentType, RightsManagementPmpComponentType, RightsManagementPipComponentType, RightsManagementPxpComponentType, RightsManagementPdpComponentType, RightsManagementPepComponentType, RightsManagementPnpComponentType, RightsManagementPnapComponentType, RightsManagementDapComponentType, RightsManagementDarpComponentType, SynchronisedStorageComponentType, FederatedCatalogueComponentType, DataSpaceConnectorComponentType } from '@twin.org/engine-types';
-import { EntityStorageConnectorFactory } from '@twin.org/entity-storage-models';
-import { IdentityProfileConnectorFactory, IdentityConnectorFactory, IdentityResolverConnectorFactory, DocumentHelper } from '@twin.org/identity-models';
-import { VaultConnectorFactory, VaultKeyType } from '@twin.org/vault-models';
-import { WalletConnectorFactory } from '@twin.org/wallet-models';
-import { execSync } from 'node:child_process';
-import { readFile, stat, readdir, mkdir, writeFile, rename } from 'node:fs/promises';
-import { get } from 'node:https';
-import path from 'node:path';
-import { CLIDisplay } from '@twin.org/cli-core';
-import { ModuleHelper } from '@twin.org/modules';
-import { PolicyNegotiationPointRestClient, DataAccessPointRestClient } from '@twin.org/rights-management-rest-client';
-import { addDefaultRestPaths, addDefaultSocketPaths, EngineServer } from '@twin.org/engine-server';
-import * as dotenv from 'dotenv';
-import { Engine } from '@twin.org/engine';
-import { FileStateStorage } from '@twin.org/engine-core';
-import { EngineCoreFactory } from '@twin.org/engine-models';
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-const ATTESTATION_VERIFICATION_METHOD_ID = "attestation-assertion";
-const IMMUTABLE_PROOF_VERIFICATION_METHOD_ID = "immutable-proof-assertion";
-const BLOB_STORAGE_ENCRYPTION_KEY_ID = "blob-encryption";
-const SYNCHRONISED_STORAGE_BLOB_STORAGE_ENCRYPTION_KEY_ID = "synchronised-storage-blob-encryption";
-const VC_AUTHENTICATION_VERIFICATION_METHOD_ID = "node-authentication-assertion";
-const AUTH_SIGNING_KEY_ID = "auth-signing";
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * The features that can be enabled on the node.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const NodeFeatures = {
-    /**
-     * NodeIdentity - generates an identity for the node if not provided in config.
-     */
-    NodeIdentity: "node-identity",
-    /**
-     * NodeUser - generates a user for the node if not provided in config.
-     */
-    NodeUser: "node-user",
-    /**
-     * NodeWallet - generates a wallet for the node and funds it when there is a faucet available.
-     */
-    NodeWallet: "node-wallet"
-};
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * The protocol types for modules.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const ModuleProtocol = {
-    /**
-     * Local module (starts with . or / or file://).
-     */
-    Local: "local",
-    /**
-     * NPM package (starts with npm:).
-     */
-    Npm: "npm",
-    /**
-     * HTTPS URL (starts with https://).
-     */
-    Https: "https",
-    /**
-     * HTTP URL (starts with http://).
-     */
-    Http: "http",
-    /**
-     * Default/standard module resolution.
-     */
-    Default: "default"
-};
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Initialise the locales for the application.
- * @param localesDirectory The directory containing the locales.
- */
-async function initialiseLocales(localesDirectory) {
-    const localesFile = path.resolve(path.join(localesDirectory, "en.json"));
-    CLIDisplay.value("Locales File", localesFile);
-    if (await fileExists(localesFile)) {
-        const enLangContent = await readFile(localesFile, "utf8");
-        I18n.addDictionary("en", JSON.parse(enLangContent));
-    }
-    else {
-        CLIDisplay.error(`Locales file not found: ${localesFile}`);
-    }
-}
-/**
- * Get the directory where the application is being executed.
- * @returns The execution directory.
- */
-function getExecutionDirectory() {
-    return process.cwd();
-}
-/**
- * Does the specified file exist.
- * @param filename The filename to check for existence.
- * @returns True if the file exists.
- */
-async function fileExists(filename) {
-    try {
-        const stats = await stat(filename);
-        return stats.isFile();
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Does the specified directory exist.
- * @param directory The directory to check for existence.
- * @returns True if the directory exists.
- */
-async function directoryExists(directory) {
-    try {
-        const stats = await stat(directory);
-        return stats.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get the sub folders for the folder.
- * @param directory The directory to get the sub folders.
- * @returns The list of sub folders.
- */
-async function getSubFolders(directory) {
-    try {
-        const dir = await readdir(directory);
-        const folders = [];
-        for (const dirEntry of dir) {
-            const fullPath = path.join(directory, dirEntry);
-            const stats = await stat(fullPath);
-            if (stats.isDirectory()) {
-                folders.push(fullPath);
-            }
-        }
-        return folders;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Get the files in the directory.
- * @param directory The directory to get the files from.
- * @returns The list of files in the directory.
- */
-async function getFiles(directory) {
-    try {
-        const dir = await readdir(directory);
-        const files = [];
-        for (const dirEntry of dir) {
-            const fullPath = path.join(directory, dirEntry);
-            const stats = await stat(fullPath);
-            if (stats.isFile()) {
-                files.push(fullPath);
-            }
-        }
-        return files;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Load the text file.
- * @param filename The filename of the text file to load.
- * @returns The contents of the text file if it could not be loaded.
- */
-async function loadTextFile(filename) {
-    return readFile(filename, "utf8");
-}
-/**
- * Load the JSON file.
- * @param filename The filename of the JSON file to load.
- * @returns The contents of the JSON file or null if it could not be loaded.
- */
-async function loadJsonFile(filename) {
-    const content = await loadTextFile(filename);
-    return JSON.parse(content);
-}
-/**
- * Get the features that are enabled on the node.
- * @param env The environment variables for the node.
- * @returns The features that are enabled on the node.
- */
-function getFeatures(env) {
-    if (Is.empty(env.features)) {
-        return [];
-    }
-    const features = [];
-    const allFeatures = Object.values(NodeFeatures);
-    const splitFeatures = env.features.split(",");
-    for (const feature of splitFeatures) {
-        const featureTrimmed = feature.trim();
-        if (allFeatures.includes(featureTrimmed)) {
-            features.push(featureTrimmed);
-        }
-    }
-    return features;
-}
-/**
- * Parse the protocol from a module name.
- * @param moduleName The module name to parse.
- * @returns The parsed protocol information.
- */
-function parseModuleProtocol(moduleName) {
-    const trimmed = moduleName.trim();
-    if (trimmed.startsWith("npm:")) {
-        return {
-            protocol: ModuleProtocol.Npm,
-            identifier: trimmed.slice(4),
-            original: trimmed
-        };
-    }
-    if (trimmed.startsWith("https://")) {
-        return {
-            protocol: ModuleProtocol.Https,
-            identifier: trimmed,
-            original: trimmed
-        };
-    }
-    if (trimmed.startsWith("http://")) {
-        return {
-            protocol: ModuleProtocol.Http,
-            identifier: trimmed,
-            original: trimmed
-        };
-    }
-    if (trimmed.startsWith("file://")) {
-        return {
-            protocol: ModuleProtocol.Local,
-            identifier: trimmed,
-            original: trimmed
-        };
-    }
-    if (ModuleHelper.isLocalModule(trimmed)) {
-        return {
-            protocol: ModuleProtocol.Local,
-            identifier: trimmed,
-            original: trimmed
-        };
-    }
-    return {
-        protocol: ModuleProtocol.Default,
-        identifier: trimmed,
-        original: trimmed
-    };
-}
-/**
- * Hash a URL to create a safe filename.
- * @param url The URL to hash.
- * @returns A hashed filename safe for the filesystem.
- */
-function hashUrl(url) {
-    const urlBytes = Converter.utf8ToBytes(url);
-    const hashBytes = Sha256.sum256(urlBytes);
-    const hash = Converter.bytesToHex(hashBytes);
-    const ext = path.extname(new URL(url).pathname);
-    return `${hash}${ext}`;
-}
-/**
- * Get the extensions cache directory.
- * @param executionDirectory The execution directory.
- * @param protocol The protocol type for subdirectory organization.
- * @param cacheDirectory The cache directory base path.
- * @returns The cache directory path.
- */
-function getExtensionsCacheDir(executionDirectory, protocol, cacheDirectory) {
-    // Resolve to absolute path to ensure consistent behavior
-    const absoluteDir = path.resolve(executionDirectory);
-    const baseDir = cacheDirectory ?? ".tmp";
-    return path.join(absoluteDir, baseDir, "extensions", protocol);
-}
-/**
- * Handle the npm: protocol by installing the package if needed.
- * @param packageName The npm package name (without npm: prefix).
- * @param executionDirectory The execution directory.
- * @param cacheDirectory The cache directory base path.
- * @returns The resolved path to the installed module.
- */
-async function handleNpmProtocol(packageName, executionDirectory, cacheDirectory) {
-    const cacheDir = getExtensionsCacheDir(executionDirectory, ModuleProtocol.Npm, cacheDirectory);
-    // Extract just the package name (without version) for the directory
-    // e.g. "picocolors@1.0.0" becomes "picocolors"
-    // e.g. "@scope/package@1.0.0" becomes "@scope/package"
-    const lastAtIndex = packageName.lastIndexOf("@");
-    const packageNameOnly = lastAtIndex > 0 ? packageName.slice(0, lastAtIndex) : packageName;
-    const packageDir = path.join(cacheDir, "node_modules", packageNameOnly);
-    const packageJsonPath = path.join(packageDir, "package.json");
-    const exists = await fileExists(packageJsonPath);
-    if (exists) {
-        const mainFile = await resolvePackageEntryPoint(packageDir, packageNameOnly);
-        const modulePath = path.join(packageDir, mainFile);
-        return {
-            resolvedPath: modulePath,
-            cached: true
-        };
-    }
-    await mkdir(cacheDir, { recursive: true });
-    CLIDisplay.task(I18n.formatMessage("node.extensionNpmInstalling"), packageName);
-    try {
-        // Always pipe stdio to comply with env access restrictions in tests/lint
-        const stdio = "pipe";
-        execSync(`npm install ${packageName} --prefix "${cacheDir}" --no-save --no-package-lock`, {
-            cwd: cacheDir,
-            stdio
-        });
-    }
-    catch (err) {
-        throw new GeneralError("node", "extensionNpmInstallFailed", {
-            package: packageName
-        }, BaseError.fromError(err));
-    }
-    const mainFile = await resolvePackageEntryPoint(packageDir, packageNameOnly);
-    const modulePath = path.join(packageDir, mainFile);
-    return {
-        resolvedPath: modulePath,
-        cached: false
-    };
-}
-/**
- * Check if a cached file has expired based on TTL and force refresh settings.
- * @param metadataPath Path to the cache metadata file.
- * @param ttlHours Time to live in hours.
- * @param forceRefresh Whether to force refresh regardless of TTL.
- * @returns True if the cache is expired or should be refreshed.
- */
-async function isCacheExpired(metadataPath, ttlHours, forceRefresh) {
-    if (forceRefresh) {
-        return true;
-    }
-    try {
-        const metadata = await loadJsonFile(metadataPath);
-        const ttlMillis = ttlHours * 60 * 60 * 1000;
-        const expireTime = metadata.downloadedAt + ttlMillis;
-        return Date.now() > expireTime;
-    }
-    catch {
-        // If metadata doesn't exist or is corrupted, consider expired
-        return true;
-    }
-}
-/**
- * Handle the https: protocol by downloading the module if needed.
- * @param url The HTTPS URL to download from.
- * @param executionDirectory The execution directory.
- * @param maxSizeMb The maximum size in MB for the download.
- * @param cacheDirectory The cache directory base path.
- * @param ttlHours TTL in hours for cache expiration.
- * @param forceRefresh Whether to force refresh the cache.
- * @returns The resolved path to the downloaded module.
- */
-async function handleHttpsProtocol(url, executionDirectory, maxSizeMb, cacheDirectory, ttlHours, forceRefresh) {
-    const effectiveTtlHours = ttlHours ?? 24;
-    const effectiveForceRefresh = forceRefresh ?? false;
-    const cacheDir = getExtensionsCacheDir(executionDirectory, ModuleProtocol.Https, cacheDirectory);
-    const filename = hashUrl(url);
-    const cachedPath = path.join(cacheDir, filename);
-    const metadataPath = `${cachedPath}.meta`;
-    const exists = await fileExists(cachedPath);
-    if (exists) {
-        const expired = await isCacheExpired(metadataPath, effectiveTtlHours, effectiveForceRefresh);
-        if (!expired) {
-            return {
-                resolvedPath: cachedPath,
-                cached: true
-            };
-        }
-        if (effectiveForceRefresh) {
-            CLIDisplay.warning(I18n.formatMessage("node.extensionForceRefresh", { url }));
-        }
-        else {
-            CLIDisplay.task(I18n.formatMessage("node.extensionCacheExpired", { url }));
-        }
-    }
-    CLIDisplay.warning(I18n.formatMessage("node.extensionSecurityWarning", { url }));
-    CLIDisplay.task(I18n.formatMessage("node.extensionHttpsDownloading"), url);
-    await mkdir(cacheDir, { recursive: true });
-    const maxSizeBytes = maxSizeMb * 1024 * 1024;
-    let downloadedSize = 0;
-    const chunks = [];
-    try {
-        await new Promise((resolve, reject) => {
-            get(url, response => {
-                if (response.statusCode !== 200) {
-                    reject(new GeneralError("node", "extensionDownloadFailed", {
-                        url,
-                        status: response.statusCode ?? 0
-                    }));
-                    return;
-                }
-                response.on("data", (chunk) => {
-                    downloadedSize += chunk.length;
-                    if (downloadedSize > maxSizeBytes) {
-                        response.destroy();
-                        reject(new GeneralError("node", "extensionSizeLimitExceeded", {
-                            size: downloadedSize,
-                            limit: maxSizeBytes
-                        }));
-                        return;
-                    }
-                    chunks.push(chunk);
-                });
-                response.on("end", () => {
-                    resolve();
-                });
-                response.on("error", err => {
-                    reject(BaseError.fromError(err));
-                });
-            }).on("error", err => {
-                reject(BaseError.fromError(err));
-            });
-        });
-    }
-    catch (err) {
-        throw new GeneralError("node", "extensionDownloadFailed", {
-            url
-        }, BaseError.fromError(err));
-    }
-    const tempPath = `${cachedPath}.tmp`;
-    await writeFile(tempPath, Buffer.concat(chunks));
-    // Atomic move from temp to final location
-    await rename(tempPath, cachedPath);
-    // Save metadata for TTL tracking
-    const metadata = {
-        downloadedAt: Date.now(),
-        url,
-        size: Buffer.concat(chunks).length
-    };
-    await writeFile(metadataPath, JSON.stringify(metadata, null, 2));
-    return {
-        resolvedPath: cachedPath,
-        cached: false
-    };
-}
-/**
- * Resolve the main entry point from a package directory using Node.js resolution with fallback.
- * Uses require.resolve() when possible for standard Node.js behavior, with manual fallback.
- * @param packagePath The absolute path to the package directory.
- * @param packageName The package name for require.resolve().
- * @param fallback The fallback file name if no entry point is found.
- * @returns The resolved entry point file name (relative to package directory).
- */
-async function resolvePackageEntryPoint(packagePath, packageName, fallback = "index.js") {
-    try {
-        // Try require.resolve() first - handles exports, main, module automatically
-        const resolvedPath = require.resolve(packageName, { paths: [path.dirname(packagePath)] });
-        // Convert absolute path back to relative filename within package
-        const relativePath = path.relative(packagePath, resolvedPath);
-        return relativePath ?? fallback;
-    }
-    catch {
-        // Fallback to manual package.json parsing if require.resolve fails
-        try {
-            const packageJsonPath = path.join(packagePath, "package.json");
-            const packageJsonContent = await loadJsonFile(packageJsonPath);
-            // Future: Could expand exports field support here
-            return packageJsonContent.module ?? packageJsonContent.main ?? fallback;
-        }
-        catch {
-            return fallback;
-        }
-    }
-}
-/**
- * Convert a file path to an import-compatible URL for cross-platform module loading.
- * On Windows, adds the 'file://' protocol prefix required for dynamic imports.
- * On other platforms, returns the path unchanged.
- * @param filePath The absolute file path to convert.
- * @returns A URL string compatible with dynamic import().
- */
-function createModuleImportUrl(filePath) {
-    return process.platform === "win32" ? `file://${filePath}` : filePath;
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-const DEFAULT_NODE_USERNAME = "admin@node";
-/**
- * Bootstrap the application.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- */
-async function bootstrap(engineCore, context, envVars) {
-    const features = getFeatures(envVars);
-    await bootstrapNodeIdentity(engineCore, context, envVars, features);
-    await bootstrapNodeUser(engineCore, context, envVars, features);
-    await bootstrapAuth(engineCore, context, envVars);
-    await bootstrapBlobEncryption(engineCore, context, envVars);
-    const defaultAttestationConnectorType = engineCore.getRegisteredInstanceTypeOptional("attestationConnector");
-    if (!Is.empty(defaultAttestationConnectorType)) {
-        await addVerificationMethod(engineCore, context, "attestation", envVars.attestationVerificationMethodId ?? ATTESTATION_VERIFICATION_METHOD_ID);
-    }
-    const defaultImmutableProofComponentType = engineCore.getRegisteredInstanceTypeOptional("immutableProofComponent");
-    if (!Is.empty(defaultImmutableProofComponentType)) {
-        await addVerificationMethod(engineCore, context, "immutable proof", envVars.immutableProofVerificationMethodId ?? IMMUTABLE_PROOF_VERIFICATION_METHOD_ID);
-    }
-    if (Coerce.boolean(envVars.vcAuthenticationEnabled) ?? false) {
-        await addVerificationMethod(engineCore, context, "verifiable credential authentication", envVars.vcAuthenticationVerificationMethodId ?? VC_AUTHENTICATION_VERIFICATION_METHOD_ID);
-    }
-    await bootstrapSynchronisedStorage(engineCore, context, envVars);
-}
-/**
- * Bootstrap the node creating any necessary resources.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node. The features that are enabled on the node.
- */
-async function bootstrapNodeIdentity(engineCore, context, envVars, features) {
-    if (features.includes(NodeFeatures.NodeIdentity)) {
-        // When we bootstrap the node we need to generate an identity for it,
-        // But we have a chicken and egg problem in that we can't create the identity
-        // to store the mnemonic in the vault without an identity. We use a temporary identity
-        // and then replace it with the new identity later in the process.
-        const defaultVaultConnectorType = engineCore.getRegisteredInstanceType("vaultConnector");
-        const vaultConnector = VaultConnectorFactory.get(defaultVaultConnectorType);
-        const workingIdentity = envVars.identity ??
-            context.state.nodeIdentity ??
-            `bootstrap-temp-${Converter.bytesToHex(RandomHelper.generate(16))}`;
-        await bootstrapMnemonic(engineCore, envVars, features, vaultConnector, workingIdentity);
-        const addresses = await bootstrapWallet(engineCore, envVars, features, workingIdentity);
-        const finalIdentity = await bootstrapIdentity(engineCore, envVars, features, workingIdentity);
-        await finaliseWallet(engineCore, envVars, features, finalIdentity, addresses);
-        await finaliseMnemonic(vaultConnector, workingIdentity, finalIdentity);
-        context.state.nodeIdentity = finalIdentity;
-        context.stateDirty = true;
-        engineCore.logInfo(I18n.formatMessage("node.nodeIdentity", {
-            identity: context.state.nodeIdentity
-        }));
-    }
-}
-/**
- * Bootstrap the identity for the node.
- * @param engineCore The engine core for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node. The features that are enabled on the node.
- * @param nodeIdentity The identity of the node.
- * @returns The addresses for the wallet.
- */
-async function bootstrapIdentity(engineCore, envVars, features, nodeIdentity) {
-    const defaultIdentityConnectorType = engineCore.getRegisteredInstanceType("identityConnector");
-    // Now create an identity for the node controlled by the address we just funded
-    const identityConnector = IdentityConnectorFactory.get(defaultIdentityConnectorType);
-    let identityDocument;
-    try {
-        const defaultIdentityResolverConnectorType = engineCore.getRegisteredInstanceType("identityResolverConnector");
-        const identityResolverConnector = IdentityResolverConnectorFactory.get(defaultIdentityResolverConnectorType);
-        identityDocument = await identityResolverConnector.resolveDocument(nodeIdentity);
-        engineCore.logInfo(I18n.formatMessage("node.existingNodeIdentity", { identity: nodeIdentity }));
-    }
-    catch { }
-    if (Is.empty(identityDocument)) {
-        engineCore.logInfo(I18n.formatMessage("node.generatingNodeIdentity"));
-        identityDocument = await identityConnector.createDocument(nodeIdentity);
-        engineCore.logInfo(I18n.formatMessage("node.createdNodeIdentity", { identity: identityDocument.id }));
-    }
-    if (defaultIdentityConnectorType.startsWith(IdentityConnectorType.Iota)) {
-        const didUrn = Urn.fromValidString(identityDocument.id);
-        const didParts = didUrn.parts();
-        const objectId = didParts[3];
-        engineCore.logInfo(I18n.formatMessage("node.identityExplorer", {
-            url: `${envVars.iotaExplorerEndpoint}object/${objectId}?network=${envVars.iotaNetwork}`
-        }));
-    }
-    return identityDocument.id;
-}
-/**
- * Bootstrap the wallet for the node.
- * @param engineCore The engine core for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- * @param nodeIdentity The identity of the node.
- * @returns The addresses for the wallet.
- */
-async function bootstrapWallet(engineCore, envVars, features, nodeIdentity) {
-    if (features.includes(NodeFeatures.NodeWallet)) {
-        const defaultWalletConnectorType = engineCore.getRegisteredInstanceType("walletConnector");
-        const walletConnector = WalletConnectorFactory.get(defaultWalletConnectorType);
-        const addresses = await walletConnector.getAddresses(nodeIdentity, 0, 0, 5);
-        const balance = await walletConnector.getBalance(nodeIdentity, addresses[0]);
-        if (balance === 0n) {
-            let address0 = addresses[0];
-            if (defaultWalletConnectorType.startsWith(WalletConnectorType.Iota)) {
-                address0 = `${envVars.iotaExplorerEndpoint}address/${address0}?network=${envVars.iotaNetwork}`;
-            }
-            engineCore.logInfo(I18n.formatMessage("node.fundingWallet", { address: address0 }));
-            // Add some funds to the wallet from the faucet
-            await walletConnector.ensureBalance(nodeIdentity, addresses[0], 1000000000n);
-        }
-        else {
-            engineCore.logInfo(I18n.formatMessage("node.fundedWallet"));
-        }
-        return addresses;
-    }
-    return [];
-}
-/**
- * Bootstrap the identity for the node.
- * @param engineCore The engine core for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- * @param finalIdentity The identity of the node.
- * @param addresses The addresses for the wallet.
- */
-async function finaliseWallet(engineCore, envVars, features, finalIdentity, addresses) {
-    if (features.includes(NodeFeatures.NodeWallet)) {
-        const defaultWalletConnectorType = engineCore.getRegisteredInstanceType("walletConnector");
-        // If we are using entity storage for wallet the identity associated with the
-        // address will be wrong, so fix it
-        if (defaultWalletConnectorType.startsWith(WalletConnectorType.EntityStorage)) {
-            const walletAddress = EntityStorageConnectorFactory.get("wallet-address");
-            const addr = await walletAddress.get(addresses[0]);
-            if (!Is.empty(addr)) {
-                addr.identity = finalIdentity;
-                await walletAddress.set(addr);
-            }
-        }
-    }
-}
-/**
- * Generate a mnemonic for the node identity.
- * @param engineCore The engine core for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- * @param vaultConnector The vault connector to use.
- * @param nodeIdentity The identity of the node.
- */
-async function bootstrapMnemonic(engineCore, envVars, features, vaultConnector, nodeIdentity) {
-    let mnemonic = envVars.mnemonic;
-    let storeMnemonic = false;
-    try {
-        const storedMnemonic = await vaultConnector.getSecret(`${nodeIdentity}/mnemonic`);
-        storeMnemonic = storedMnemonic !== mnemonic;
-        mnemonic = storedMnemonic;
-    }
-    catch {
-        storeMnemonic = true;
-    }
-    // If there is no mnemonic then we need to generate one
-    if (Is.empty(mnemonic)) {
-        mnemonic = Bip39.randomMnemonic();
-        storeMnemonic = true;
-        engineCore.logInfo(I18n.formatMessage("node.generatingMnemonic", { mnemonic }));
-    }
-    // If there is no mnemonic stored in the vault then we need to store it
-    if (storeMnemonic) {
-        engineCore.logInfo(I18n.formatMessage("node.storingMnemonic"));
-        await vaultConnector.setSecret(`${nodeIdentity}/mnemonic`, mnemonic);
-    }
-    else {
-        engineCore.logInfo(I18n.formatMessage("node.existingMnemonic"));
-    }
-}
-/**
- * Finalise the mnemonic for the node identity.
- * @param vaultConnector The vault connector to use.
- * @param workingIdentity The identity of the node.
- * @param finalIdentity The final identity for the node.
- */
-async function finaliseMnemonic(vaultConnector, workingIdentity, finalIdentity) {
-    // Now that we have an identity we can remove the temporary one
-    // and store the mnemonic with the new identity
-    if (workingIdentity.startsWith("bootstrap-temp-") && workingIdentity !== finalIdentity) {
-        const mnemonic = await vaultConnector.getSecret(`${workingIdentity}/mnemonic`);
-        await vaultConnector.setSecret(`${finalIdentity}/mnemonic`, mnemonic);
-        await vaultConnector.removeSecret(`${workingIdentity}/mnemonic`);
-    }
-}
-/**
- * Bootstrap the user.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- */
-async function bootstrapNodeUser(engineCore, context, envVars, features) {
-    if (features.includes(NodeFeatures.NodeUser)) {
-        const defaultAuthenticationComponentType = engineCore.getRegisteredInstanceType("authenticationComponent");
-        if (defaultAuthenticationComponentType.startsWith(AuthenticationComponentType.EntityStorage) &&
-            Is.stringValue(context.state.nodeIdentity)) {
-            const authUserEntityStorage = EntityStorageConnectorFactory.get("authentication-user");
-            const email = envVars.username ?? DEFAULT_NODE_USERNAME;
-            let nodeAdminUser = await authUserEntityStorage.get(email);
-            if (Is.empty(nodeAdminUser)) {
-                engineCore.logInfo(I18n.formatMessage("node.creatingNodeUser", { email }));
-                const generatedPassword = envVars.password ?? PasswordGenerator.generate(16);
-                const passwordBytes = Converter.utf8ToBytes(generatedPassword);
-                const saltBytes = RandomHelper.generate(16);
-                const hashedPassword = await PasswordHelper.hashPassword(passwordBytes, saltBytes);
-                nodeAdminUser = {
-                    email,
-                    password: hashedPassword,
-                    salt: Converter.bytesToBase64(saltBytes),
-                    identity: context.state.nodeIdentity
-                };
-                engineCore.logInfo(I18n.formatMessage("node.nodeAdminUserEmail", { email: nodeAdminUser.email }));
-                engineCore.logInfo(I18n.formatMessage("node.nodeAdminUserPassword", { password: generatedPassword }));
-                await authUserEntityStorage.set(nodeAdminUser);
-            }
-            else {
-                engineCore.logInfo(I18n.formatMessage("node.existingNodeUser", { email }));
-                // The user already exists, so double check the other details match
-                let needsUpdate = false;
-                if (nodeAdminUser.identity !== context.state.nodeIdentity) {
-                    nodeAdminUser.identity = context.state.nodeIdentity;
-                    needsUpdate = true;
-                }
-                if (Is.stringValue(envVars.password)) {
-                    const passwordBytes = Converter.utf8ToBytes(envVars.password);
-                    const saltBytes = Converter.base64ToBytes(nodeAdminUser.salt);
-                    const hashedPassword = await PasswordHelper.hashPassword(passwordBytes, saltBytes);
-                    if (nodeAdminUser.password !== hashedPassword) {
-                        nodeAdminUser.password = hashedPassword;
-                        needsUpdate = true;
-                    }
-                }
-                if (needsUpdate) {
-                    await authUserEntityStorage.set(nodeAdminUser);
-                }
-            }
-            // We have create a node user, now we need to create a profile for the user
-            const defaultIdentityProfileConnectorType = engineCore.getRegisteredInstanceType("identityProfileConnector");
-            const identityProfileConnector = IdentityProfileConnectorFactory.get(defaultIdentityProfileConnectorType);
-            if (identityProfileConnector) {
-                let userProfile;
-                try {
-                    userProfile = await identityProfileConnector.get(context.state.nodeIdentity);
-                }
-                catch { }
-                if (Is.empty(userProfile)) {
-                    engineCore.logInfo(I18n.formatMessage("node.creatingUserProfile", { identity: context.state.nodeIdentity }));
-                    const publicProfile = {
-                        "@context": "https://schema.org",
-                        "@type": "Person",
-                        name: "Node Administrator"
-                    };
-                    const privateProfile = {
-                        "@context": "https://schema.org",
-                        "@type": "Person",
-                        givenName: "Node",
-                        familyName: "Administrator",
-                        email
-                    };
-                    await identityProfileConnector.create(context.state.nodeIdentity, publicProfile, privateProfile);
-                }
-                else {
-                    engineCore.logInfo(I18n.formatMessage("node.existingUserProfile", { identity: context.state.nodeIdentity }));
-                }
-            }
-        }
-    }
-}
-/**
- * Bootstrap the immutable proof verification methods.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- */
-async function bootstrapImmutableProofMethod(engineCore, context, envVars, features) { }
-/**
- * Bootstrap the keys for blob encryption.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- */
-async function bootstrapBlobEncryption(engineCore, context, envVars, features) {
-    if ((Coerce.boolean(envVars.blobStorageEnableEncryption) ?? false) &&
-        Is.stringValue(context.state.nodeIdentity)) {
-        // Create a new key for encrypting blobs
-        const defaultVaultConnectorType = engineCore.getRegisteredInstanceType("vaultConnector");
-        const vaultConnector = VaultConnectorFactory.get(defaultVaultConnectorType);
-        const keyName = `${context.state.nodeIdentity}/${envVars.blobStorageEncryptionKeyId ?? BLOB_STORAGE_ENCRYPTION_KEY_ID}`;
-        let existingKey;
-        try {
-            existingKey = await vaultConnector.getKey(keyName);
-        }
-        catch { }
-        if (Is.empty(existingKey)) {
-            if (Is.stringBase64(envVars.blobStorageSymmetricEncryptionKey)) {
-                engineCore.logInfo(I18n.formatMessage("node.addingBlobEncryptionKey", { keyName }));
-                await vaultConnector.addKey(keyName, VaultKeyType.ChaCha20Poly1305, Converter.base64ToBytes(envVars.blobStorageSymmetricEncryptionKey));
-            }
-            else {
-                engineCore.logInfo(I18n.formatMessage("node.creatingBlobEncryptionKey", { keyName }));
-                const key = await vaultConnector.createKey(keyName, VaultKeyType.ChaCha20Poly1305);
-                engineCore.logInfo(I18n.formatMessage("node.createdBlobEncryptionKey", {
-                    keyName,
-                    keyValue: Converter.bytesToBase64(key)
-                }));
-            }
-        }
-        else {
-            engineCore.logInfo(I18n.formatMessage("node.existingBlobEncryptionKey", { keyName }));
-        }
-    }
-}
-/**
- * Bootstrap the JWT signing key.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- */
-async function bootstrapAuth(engineCore, context, envVars, features) {
-    const defaultAuthenticationComponentType = engineCore.getRegisteredInstanceTypeOptional("authenticationComponent");
-    if (Is.stringValue(defaultAuthenticationComponentType) &&
-        defaultAuthenticationComponentType.startsWith(AuthenticationComponentType.EntityStorage) &&
-        Is.stringValue(context.state.nodeIdentity)) {
-        // Create a new JWT signing key and a user login for the node
-        const defaultVaultConnectorType = engineCore.getRegisteredInstanceType("vaultConnector");
-        const vaultConnector = VaultConnectorFactory.get(defaultVaultConnectorType);
-        const keyName = `${context.state.nodeIdentity}/${envVars.authSigningKeyId ?? AUTH_SIGNING_KEY_ID}`;
-        let existingKey;
-        try {
-            existingKey = await vaultConnector.getKey(keyName);
-        }
-        catch { }
-        if (Is.empty(existingKey)) {
-            engineCore.logInfo(I18n.formatMessage("node.creatingAuthKey", { keyName }));
-            await vaultConnector.createKey(keyName, VaultKeyType.Ed25519);
-        }
-        else {
-            engineCore.logInfo(I18n.formatMessage("node.existingAuthKey", { keyName }));
-        }
-    }
-}
-/**
- * Bootstrap the synchronised storage blob encryption and verification methods.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param envVars The environment variables for the node.
- * @param features The features that are enabled on the node.
- */
-async function bootstrapSynchronisedStorage(engineCore, context, envVars, features) {
-    if (Coerce.boolean(envVars.synchronisedStorageEnabled) ?? false) {
-        // If this is a trusted node we need to add the blob encryption key pair
-        if (Is.stringBase64(envVars.synchronisedStorageBlobStorageKey)) {
-            const defaultVaultConnectorType = engineCore.getRegisteredInstanceType("vaultConnector");
-            const vaultConnector = VaultConnectorFactory.get(defaultVaultConnectorType);
-            const keyName = envVars.synchronisedStorageBlobStorageEncryptionKeyId ??
-                SYNCHRONISED_STORAGE_BLOB_STORAGE_ENCRYPTION_KEY_ID;
-            let existingKey;
-            try {
-                existingKey = await vaultConnector.getKey(keyName);
-            }
-            catch { }
-            if (Is.empty(existingKey)) {
-                engineCore.logInfo(I18n.formatMessage("node.addingSynchronisedStorageBlobEncryptionKey", { keyName }));
-                await vaultConnector.addKey(keyName, VaultKeyType.ChaCha20Poly1305, Converter.base64ToBytes(envVars.synchronisedStorageBlobStorageKey));
-            }
-            else {
-                engineCore.logInfo(I18n.formatMessage("node.existingSynchronisedStorageBlobEncryptionKey", { keyName }));
-            }
-        }
-    }
-}
-/**
- * Add a verification method if it doesn't exist.
- * @param engineCore The engine core for the node.
- * @param context The context for the node.
- * @param verificationMethodTitle The verification method title.
- * @param verificationMethodId The verification method ID.
- */
-async function addVerificationMethod(engineCore, context, verificationMethodTitle, verificationMethodId) {
-    if (Is.stringValue(context.state.nodeIdentity) &&
-        Is.arrayValue(context.config.types.identityConnector) &&
-        Is.stringValue(verificationMethodId)) {
-        const defaultIdentityConnectorType = engineCore.getRegisteredInstanceType("identityConnector");
-        const identityConnector = IdentityConnectorFactory.get(defaultIdentityConnectorType);
-        const defaultIdentityResolverConnectorType = engineCore.getRegisteredInstanceType("identityResolverConnector");
-        const identityResolverConnector = IdentityResolverConnectorFactory.get(defaultIdentityResolverConnectorType);
-        const identityDocument = await identityResolverConnector.resolveDocument(context.state.nodeIdentity);
-        const fullMethodId = `${identityDocument.id}#${verificationMethodId}`;
-        let exists = false;
-        try {
-            DocumentHelper.getVerificationMethod(identityDocument, fullMethodId, "assertionMethod");
-            exists = true;
-        }
-        catch { }
-        if (!exists) {
-            engineCore.logInfo(I18n.formatMessage("node.addingVerificationMethod", {
-                title: verificationMethodTitle,
-                methodId: fullMethodId
-            }));
-            await identityConnector.addVerificationMethod(context.state.nodeIdentity, context.state.nodeIdentity, "assertionMethod", verificationMethodId);
-        }
-        else {
-            engineCore.logInfo(I18n.formatMessage("node.existingVerificationMethod", {
-                title: verificationMethodTitle,
-                methodId: fullMethodId
-            }));
-        }
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Build the engine core configuration from environment variables.
- * @param envVars The environment variables.
- * @returns The config for the core.
- */
-async function buildEngineConfiguration(envVars) {
-    if (Is.stringValue(envVars.storageFileRoot)) {
-        envVars.stateFilename ??= "engine-state.json";
-        envVars.storageFileRoot = path.resolve(envVars.storageFileRoot);
-        envVars.stateFilename = path.join(envVars.storageFileRoot, envVars.stateFilename);
-    }
-    const coreConfig = {
-        debug: Coerce.boolean(envVars.debug) ?? false,
-        types: {}
-    };
-    await configureEntityStorage(coreConfig, envVars);
-    await configureBlobStorage(coreConfig, envVars);
-    await configureVault(coreConfig, envVars);
-    await configureDlt(coreConfig, envVars);
-    await configureLogging(coreConfig, envVars);
-    await configureBackgroundTask(coreConfig, envVars);
-    await configureTaskScheduler(coreConfig, envVars);
-    await configureEventBus(coreConfig, envVars);
-    await configureTelemetry(coreConfig, envVars);
-    await configureMessaging(coreConfig, envVars);
-    await configureFaucet(coreConfig, envVars);
-    await configureWallet(coreConfig, envVars);
-    await configureNft(coreConfig, envVars);
-    await configureVerifiableStorage(coreConfig, envVars);
-    await configureIdentity(coreConfig, envVars);
-    await configureIdentityResolver(coreConfig, envVars);
-    await configureIdentityProfile(coreConfig, envVars);
-    await configureAttestation(coreConfig, envVars);
-    await configureDataProcessing(coreConfig, envVars);
-    await configureAuditableItemGraph(coreConfig, envVars);
-    await configureAuditableItemStream(coreConfig, envVars);
-    await configureDocumentManagement(coreConfig, envVars);
-    await configureVerifiableCredentialAuthentication(coreConfig, envVars);
-    await configureRightsManagement(coreConfig, envVars);
-    await configureSynchronisedStorage(coreConfig, envVars);
-    await configureFederatedCatalogue(coreConfig, envVars);
-    await configureDataSpaceConnector(coreConfig, envVars);
-    return coreConfig;
-}
-/**
- * Configures the entity storage.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureEntityStorage(coreConfig, envVars) {
-    coreConfig.types ??= {};
-    coreConfig.types.entityStorageConnector ??= [];
-    const entityStorageConnectorTypes = envVars.entityStorageConnectorType?.split(",") ?? [];
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.Memory)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.Memory
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.File)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.File,
-            options: {
-                config: { directory: envVars.storageFileRoot ?? "" },
-                folderPrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.AwsDynamoDb)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.AwsDynamoDb,
-            options: {
-                config: {
-                    region: envVars.awsDynamodbRegion ?? "",
-                    authMode: envVars.awsDynamodbAuthMode,
-                    accessKeyId: envVars.awsDynamodbAccessKeyId,
-                    secretAccessKey: envVars.awsDynamodbSecretAccessKey,
-                    endpoint: envVars.awsDynamodbEndpoint
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.AzureCosmosDb)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.AzureCosmosDb,
-            options: {
-                config: {
-                    endpoint: envVars.azureCosmosdbEndpoint ?? "",
-                    key: envVars.azureCosmosdbKey ?? "",
-                    databaseId: envVars.azureCosmosdbDatabaseId ?? "",
-                    containerId: envVars.azureCosmosdbContainerId ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.GcpFirestoreDb)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.GcpFirestoreDb,
-            options: {
-                config: {
-                    projectId: envVars.gcpFirestoreProjectId ?? "",
-                    credentials: envVars.gcpFirestoreCredentials ?? "",
-                    databaseId: envVars.gcpFirestoreDatabaseId ?? "",
-                    collectionName: envVars.gcpFirestoreCollectionName ?? "",
-                    endpoint: envVars.gcpFirestoreApiEndpoint ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.ScyllaDb)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.ScyllaDb,
-            options: {
-                config: {
-                    hosts: envVars.scylladbHosts?.split(",") ?? [],
-                    localDataCenter: envVars.scylladbLocalDataCenter ?? "",
-                    keyspace: envVars.scylladbKeyspace ?? "",
-                    port: Coerce.integer(envVars.scylladbPort)
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.MySqlDb)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.MySqlDb,
-            options: {
-                config: {
-                    host: envVars.mySqlHost ?? "",
-                    port: Coerce.integer(envVars.mySqlPort),
-                    user: envVars.mySqlUser ?? "",
-                    password: envVars.mySqlPassword ?? "",
-                    database: envVars.mySqlDatabase ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.MongoDb)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.MongoDb,
-            options: {
-                config: {
-                    host: envVars.mongoDbHost ?? "",
-                    port: Coerce.integer(envVars.mongoDbPort),
-                    user: envVars.mongoDbUser ?? "",
-                    password: envVars.mongoDbPassword ?? "",
-                    database: envVars.mongoDbDatabase ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.PostgreSql)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.PostgreSql,
-            options: {
-                config: {
-                    host: envVars.postgreSqlHost ?? "",
-                    port: Coerce.integer(envVars.postgreSqlPort),
-                    user: envVars.postgreSqlUser ?? "",
-                    password: envVars.postgreSqlPassword ?? "",
-                    database: envVars.postgreSqlDatabase ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    const defaultEntityStorageConnectorType = envVars.entityStorageConnectorDefault ?? entityStorageConnectorTypes[0];
-    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.Synchronised)) {
-        // For synchronised storage we use the default connector as the one we wrap for real DB operations
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.Synchronised,
-            options: {
-                entityStorageConnectorType: defaultEntityStorageConnectorType
-            }
-        });
-    }
-    if (Is.arrayValue(entityStorageConnectorTypes)) {
-        for (const config of coreConfig.types.entityStorageConnector) {
-            if (config.type === defaultEntityStorageConnectorType) {
-                config.isDefault = true;
-                break;
-            }
-        }
-    }
-}
-/**
- * Configures the blob storage.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureBlobStorage(coreConfig, envVars) {
-    coreConfig.types.blobStorageConnector ??= [];
-    const blobStorageConnectorTypes = envVars.blobStorageConnectorType?.split(",") ?? [];
-    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.Memory)) {
-        coreConfig.types.blobStorageConnector.push({
-            type: BlobStorageConnectorType.Memory
-        });
-    }
-    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.File)) {
-        coreConfig.types.blobStorageConnector.push({
-            type: BlobStorageConnectorType.File,
-            options: {
-                config: {
-                    directory: Is.stringValue(envVars.storageFileRoot)
-                        ? path.join(envVars.storageFileRoot, "blob-storage")
-                        : ""
-                },
-                storagePrefix: envVars.blobStoragePrefix
-            }
-        });
-    }
-    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.Ipfs)) {
-        coreConfig.types.blobStorageConnector.push({
-            type: BlobStorageConnectorType.Ipfs,
-            options: {
-                config: {
-                    apiUrl: envVars.ipfsApiUrl ?? "",
-                    bearerToken: envVars.ipfsBearerToken
-                }
-            }
-        });
-    }
-    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.AwsS3)) {
-        coreConfig.types.blobStorageConnector.push({
-            type: BlobStorageConnectorType.AwsS3,
-            options: {
-                config: {
-                    region: envVars.awsS3Region ?? "",
-                    bucketName: envVars.awsS3BucketName ?? "",
-                    authMode: envVars.awsS3AuthMode,
-                    accessKeyId: envVars.awsS3AccessKeyId,
-                    secretAccessKey: envVars.awsS3SecretAccessKey,
-                    endpoint: envVars.awsS3Endpoint
-                },
-                storagePrefix: envVars.blobStoragePrefix
-            }
-        });
-    }
-    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.AzureStorage)) {
-        coreConfig.types.blobStorageConnector.push({
-            type: BlobStorageConnectorType.AzureStorage,
-            options: {
-                config: {
-                    accountName: envVars.azureStorageAccountName ?? "",
-                    accountKey: envVars.azureStorageAccountKey ?? "",
-                    containerName: envVars.azureStorageContainerName ?? "",
-                    endpoint: envVars.azureStorageEndpoint ?? ""
-                },
-                storagePrefix: envVars.blobStoragePrefix
-            }
-        });
-    }
-    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.GcpStorage)) {
-        coreConfig.types.blobStorageConnector.push({
-            type: BlobStorageConnectorType.GcpStorage,
-            options: {
-                config: {
-                    projectId: envVars.gcpStorageProjectId ?? "",
-                    credentials: envVars.gcpStorageCredentials ?? "",
-                    bucketName: envVars.gcpStorageBucketName ?? "",
-                    apiEndpoint: envVars.gcpFirestoreApiEndpoint
-                },
-                storagePrefix: envVars.blobStoragePrefix
-            }
-        });
-    }
-    if (Is.arrayValue(blobStorageConnectorTypes)) {
-        const defaultStorageConnectorType = envVars.blobStorageConnectorDefault ?? blobStorageConnectorTypes[0];
-        for (const config of coreConfig.types.blobStorageConnector) {
-            if (config.type === defaultStorageConnectorType) {
-                config.isDefault = true;
-            }
-            // If this blob storage connector is the one to use for public access
-            // then add it as a feature
-            if (Is.stringValue(envVars.blobStorageConnectorPublic) &&
-                config.type === envVars.blobStorageConnectorPublic) {
-                config.features ??= [];
-                config.features.push("public");
-                break;
-            }
-        }
-    }
-    if (coreConfig.types.blobStorageConnector.length > 0) {
-        coreConfig.types.blobStorageComponent ??= [];
-        coreConfig.types.blobStorageComponent.push({
-            type: BlobStorageComponentType.Service,
-            options: {
-                config: {
-                    vaultKeyId: (envVars.blobStorageEnableEncryption ?? false)
-                        ? (envVars.blobStorageEncryptionKeyId ?? BLOB_STORAGE_ENCRYPTION_KEY_ID)
-                        : undefined
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the logging.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureLogging(coreConfig, envVars) {
-    coreConfig.types.loggingConnector ??= [];
-    const loggingConnectorTypes = (envVars.loggingConnector ?? "").split(",");
-    let additionalConnectorCount = 0;
-    for (const loggingConnector of loggingConnectorTypes) {
-        if (loggingConnector === LoggingConnectorType.Console) {
-            coreConfig.types.loggingConnector.push({
-                type: LoggingConnectorType.Console,
-                options: {
-                    config: {
-                        translateMessages: true,
-                        hideGroups: true
-                    }
-                }
-            });
-            additionalConnectorCount++;
-        }
-        else if (loggingConnector === LoggingConnectorType.EntityStorage) {
-            coreConfig.types.loggingConnector.push({
-                type: LoggingConnectorType.EntityStorage
-            });
-            additionalConnectorCount++;
-        }
-    }
-    // If more than one logging connector, then we need to add a multi connector
-    // and set it as the default one
-    if (additionalConnectorCount > 1) {
-        coreConfig.types.loggingConnector.push({
-            type: LoggingConnectorType.Multi,
-            options: {
-                loggingConnectorTypes
-            },
-            isDefault: true
-        });
-    }
-    else if (additionalConnectorCount > 0) {
-        // If only one connector, then we set it as the default one
-        coreConfig.types.loggingConnector[coreConfig.types.loggingConnector.length - 1].isDefault =
-            true;
-    }
-    if (additionalConnectorCount > 0) {
-        coreConfig.types.loggingComponent ??= [];
-        // We set the isDefault flag so that other components will get this service by default
-        // and not the generic one from the engine core
-        coreConfig.types.loggingComponent.push({ type: LoggingComponentType.Service, isDefault: true });
-    }
-}
-/**
- * Configures the vault.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureVault(coreConfig, envVars) {
-    coreConfig.types.vaultConnector ??= [];
-    if (envVars.vaultConnector === VaultConnectorType.EntityStorage) {
-        coreConfig.types.vaultConnector.push({
-            type: VaultConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.vaultConnector === VaultConnectorType.Hashicorp) {
-        coreConfig.types.vaultConnector.push({
-            type: VaultConnectorType.Hashicorp,
-            options: {
-                config: {
-                    endpoint: envVars.hashicorpVaultEndpoint ?? "",
-                    token: envVars.hashicorpVaultToken ?? ""
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the background task.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureBackgroundTask(coreConfig, envVars) {
-    coreConfig.types.backgroundTaskConnector ??= [];
-    if (envVars.backgroundTaskConnector === BackgroundTaskConnectorType.EntityStorage) {
-        coreConfig.types.backgroundTaskConnector.push({
-            type: BackgroundTaskConnectorType.EntityStorage
-        });
-    }
-}
-/**
- * Configures the event bud.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureEventBus(coreConfig, envVars) {
-    coreConfig.types.eventBusConnector ??= [];
-    if (envVars.eventBusConnector === EventBusConnectorType.Local) {
-        coreConfig.types.eventBusConnector.push({
-            type: EventBusConnectorType.Local
-        });
-    }
-    if (coreConfig.types.eventBusConnector.length > 0) {
-        coreConfig.types.eventBusComponent ??= [];
-        coreConfig.types.eventBusComponent.push({ type: EventBusComponentType.Service });
-    }
-}
-/**
- * Configures the telemetry.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureTelemetry(coreConfig, envVars) {
-    coreConfig.types.telemetryConnector ??= [];
-    if (envVars.telemetryConnector === TelemetryConnectorType.EntityStorage) {
-        coreConfig.types.telemetryConnector.push({
-            type: TelemetryConnectorType.EntityStorage
-        });
-    }
-    if (coreConfig.types.telemetryConnector.length > 0) {
-        coreConfig.types.telemetryComponent ??= [];
-        coreConfig.types.telemetryComponent.push({ type: TelemetryComponentType.Service });
-    }
-}
-/**
- * Configures the messaging.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureMessaging(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.messagingEnabled) ?? false) {
-        coreConfig.types.messagingEmailConnector ??= [];
-        coreConfig.types.messagingSmsConnector ??= [];
-        coreConfig.types.messagingPushNotificationConnector ??= [];
-        if (envVars.messagingEmailConnector === MessagingEmailConnectorType.EntityStorage) {
-            coreConfig.types.messagingEmailConnector.push({
-                type: MessagingEmailConnectorType.EntityStorage
-            });
-        }
-        else if (envVars.messagingEmailConnector === MessagingEmailConnectorType.Aws) {
-            coreConfig.types.messagingEmailConnector.push({
-                type: MessagingEmailConnectorType.Aws,
-                options: {
-                    config: {
-                        region: envVars.awsSesRegion ?? "",
-                        authMode: envVars.awsSesAuthMode,
-                        accessKeyId: envVars.awsSesAccessKeyId,
-                        secretAccessKey: envVars.awsSesSecretAccessKey,
-                        endpoint: envVars.awsSesEndpoint
-                    }
-                }
-            });
-        }
-        if (envVars.messagingSmsConnector === MessagingSmsConnectorType.EntityStorage) {
-            coreConfig.types.messagingSmsConnector.push({
-                type: MessagingSmsConnectorType.EntityStorage
-            });
-        }
-        else if (envVars.messagingSmsConnector === MessagingSmsConnectorType.Aws) {
-            coreConfig.types.messagingSmsConnector.push({
-                type: MessagingSmsConnectorType.Aws,
-                options: {
-                    config: {
-                        region: envVars.awsSesRegion ?? "",
-                        authMode: envVars.awsSesAuthMode,
-                        accessKeyId: envVars.awsSesAccessKeyId,
-                        secretAccessKey: envVars.awsSesSecretAccessKey,
-                        endpoint: envVars.awsSesEndpoint
-                    }
-                }
-            });
-        }
-        if (envVars.messagingPushNotificationConnector ===
-            MessagingPushNotificationConnectorType.EntityStorage) {
-            coreConfig.types.messagingPushNotificationConnector.push({
-                type: MessagingPushNotificationConnectorType.EntityStorage
-            });
-        }
-        else if (envVars.messagingPushNotificationConnector === MessagingPushNotificationConnectorType.Aws) {
-            coreConfig.types.messagingPushNotificationConnector.push({
-                type: MessagingPushNotificationConnectorType.Aws,
-                options: {
-                    config: {
-                        region: envVars.awsSesRegion ?? "",
-                        authMode: envVars.awsSesAuthMode,
-                        accessKeyId: envVars.awsSesAccessKeyId,
-                        secretAccessKey: envVars.awsSesSecretAccessKey,
-                        endpoint: envVars.awsSesEndpoint,
-                        applicationsSettings: Is.json(envVars.awsMessagingPushNotificationApplications)
-                            ? JSON.parse(envVars.awsMessagingPushNotificationApplications)
-                            : []
-                    }
-                }
-            });
-        }
-        const templates = Is.arrayValue(envVars.messagingTemplates)
-            ? envVars.messagingTemplates
-            : undefined;
-        coreConfig.types.messagingAdminComponent ??= [];
-        coreConfig.types.messagingAdminComponent.push({
-            type: MessagingAdminComponentType.Service,
-            options: {
-                config: {
-                    templates
-                }
-            }
-        });
-        coreConfig.types.messagingComponent ??= [];
-        coreConfig.types.messagingComponent.push({ type: MessagingComponentType.Service });
-    }
-}
-/**
- * Configures the faucet.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureFaucet(coreConfig, envVars) {
-    coreConfig.types.faucetConnector ??= [];
-    if (envVars.faucetConnector === FaucetConnectorType.EntityStorage) {
-        coreConfig.types.faucetConnector.push({
-            type: FaucetConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.faucetConnector === FaucetConnectorType.Iota) {
-        const dltConfig = EngineTypeHelper.getConfigOfType(coreConfig, "dltConfig", DltConfigType.Iota);
-        coreConfig.types.faucetConnector.push({
-            type: FaucetConnectorType.Iota,
-            options: {
-                config: {
-                    endpoint: envVars.iotaFaucetEndpoint ?? "",
-                    clientOptions: dltConfig?.options?.config?.clientOptions ?? { url: "" },
-                    network: dltConfig?.options?.config?.network ?? ""
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the wallet.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureWallet(coreConfig, envVars) {
-    coreConfig.types.walletConnector ??= [];
-    if (envVars.walletConnector === WalletConnectorType.EntityStorage) {
-        coreConfig.types.walletConnector.push({
-            type: WalletConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.walletConnector === WalletConnectorType.Iota) {
-        const dltConfig = EngineTypeHelper.getConfigOfType(coreConfig, "dltConfig", DltConfigType.Iota);
-        coreConfig.types.walletConnector.push({
-            type: WalletConnectorType.Iota,
-            options: {
-                config: dltConfig?.options?.config ?? {}
-            }
-        });
-    }
-}
-/**
- * Configures the NFT.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureNft(coreConfig, envVars) {
-    coreConfig.types.nftConnector ??= [];
-    if (envVars.nftConnector === NftConnectorType.EntityStorage) {
-        coreConfig.types.nftConnector.push({
-            type: NftConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.nftConnector === NftConnectorType.Iota) {
-        const dltConfig = EngineTypeHelper.getConfigOfType(coreConfig, "dltConfig", DltConfigType.Iota);
-        coreConfig.types.nftConnector.push({
-            type: NftConnectorType.Iota,
-            options: {
-                config: dltConfig?.options?.config ?? {}
-            }
-        });
-    }
-    if (coreConfig.types.nftConnector.length > 0) {
-        coreConfig.types.nftComponent ??= [];
-        coreConfig.types.nftComponent.push({ type: NftComponentType.Service });
-    }
-}
-/**
- * Configures the verifiable storage.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureVerifiableStorage(coreConfig, envVars) {
-    coreConfig.types.verifiableStorageConnector ??= [];
-    if (envVars.verifiableStorageConnector === VerifiableStorageConnectorType.EntityStorage) {
-        coreConfig.types.verifiableStorageConnector.push({
-            type: VerifiableStorageConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.verifiableStorageConnector === VerifiableStorageConnectorType.Iota) {
-        const dltConfig = EngineTypeHelper.getConfigOfType(coreConfig, "dltConfig", DltConfigType.Iota);
-        coreConfig.types.verifiableStorageConnector.push({
-            type: VerifiableStorageConnectorType.Iota,
-            options: {
-                config: dltConfig?.options?.config ?? {}
-            }
-        });
-    }
-    if (coreConfig.types.verifiableStorageConnector.length > 0) {
-        coreConfig.types.verifiableStorageComponent ??= [];
-        coreConfig.types.verifiableStorageComponent.push({
-            type: VerifiableStorageComponentType.Service
-        });
-        coreConfig.types.immutableProofComponent ??= [];
-        coreConfig.types.immutableProofComponent.push({
-            type: ImmutableProofComponentType.Service,
-            options: {
-                config: {
-                    verificationMethodId: envVars.immutableProofVerificationMethodId ?? IMMUTABLE_PROOF_VERIFICATION_METHOD_ID
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the identity.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureIdentity(coreConfig, envVars) {
-    coreConfig.types.identityConnector ??= [];
-    if (envVars.identityConnector === IdentityConnectorType.EntityStorage) {
-        coreConfig.types.identityConnector.push({
-            type: IdentityConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.identityConnector === IdentityConnectorType.Iota) {
-        const dltConfig = EngineTypeHelper.getConfigOfType(coreConfig, "dltConfig", DltConfigType.Iota);
-        coreConfig.types.identityConnector.push({
-            type: IdentityConnectorType.Iota,
-            options: {
-                config: dltConfig?.options?.config ?? {}
-            }
-        });
-    }
-    if (coreConfig.types.identityConnector.length > 0) {
-        coreConfig.types.identityComponent ??= [];
-        coreConfig.types.identityComponent.push({ type: IdentityComponentType.Service });
-    }
-}
-/**
- * Configures the identity resolver.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureIdentityResolver(coreConfig, envVars) {
-    coreConfig.types.identityResolverConnector ??= [];
-    if (envVars.identityResolverConnector === IdentityResolverConnectorType.EntityStorage) {
-        coreConfig.types.identityResolverConnector.push({
-            type: IdentityResolverConnectorType.EntityStorage
-        });
-    }
-    else if (envVars.identityResolverConnector === IdentityResolverConnectorType.Iota) {
-        const dltConfig = EngineTypeHelper.getConfigOfType(coreConfig, "dltConfig", DltConfigType.Iota);
-        coreConfig.types.identityResolverConnector.push({
-            type: IdentityResolverConnectorType.Iota,
-            options: {
-                config: dltConfig?.options?.config ?? {}
-            }
-        });
-    }
-    else if (envVars.identityResolverConnector === IdentityResolverConnectorType.Universal) {
-        coreConfig.types.identityResolverConnector.push({
-            type: IdentityResolverConnectorType.Universal,
-            options: {
-                config: {
-                    endpoint: envVars.universalResolverEndpoint ?? ""
-                }
-            }
-        });
-    }
-    if (coreConfig.types.identityResolverConnector.length > 0) {
-        coreConfig.types.identityResolverComponent ??= [];
-        coreConfig.types.identityResolverComponent.push({
-            type: IdentityResolverComponentType.Service
-        });
-    }
-}
-/**
- * Configures the identity profile.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureIdentityProfile(coreConfig, envVars) {
-    coreConfig.types.identityProfileConnector ??= [];
-    if (envVars.identityProfileConnector === IdentityConnectorType.EntityStorage) {
-        coreConfig.types.identityProfileConnector.push({
-            type: IdentityProfileConnectorType.EntityStorage
-        });
-    }
-    if (coreConfig.types.identityProfileConnector.length > 0) {
-        coreConfig.types.identityProfileComponent ??= [];
-        coreConfig.types.identityProfileComponent.push({ type: IdentityProfileComponentType.Service });
-    }
-}
-/**
- * Configures the attestation.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureAttestation(coreConfig, envVars) {
-    coreConfig.types.attestationConnector ??= [];
-    if (envVars.attestationConnector === AttestationConnectorType.Nft) {
-        coreConfig.types.attestationConnector.push({
-            type: AttestationConnectorType.Nft
-        });
-    }
-    if (coreConfig.types.attestationConnector.length > 0) {
-        coreConfig.types.attestationComponent ??= [];
-        coreConfig.types.attestationComponent.push({
-            type: AttestationComponentType.Service,
-            options: {
-                config: {
-                    verificationMethodId: envVars.attestationVerificationMethodId ?? ATTESTATION_VERIFICATION_METHOD_ID
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the auditable item graph.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureAuditableItemGraph(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.auditableItemGraphEnabled) ?? false) {
-        coreConfig.types.auditableItemGraphComponent ??= [];
-        coreConfig.types.auditableItemGraphComponent.push({
-            type: AuditableItemGraphComponentType.Service
-        });
-    }
-}
-/**
- * Configures the auditable item stream.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureAuditableItemStream(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.auditableItemStreamEnabled) ?? false) {
-        coreConfig.types.auditableItemStreamComponent ??= [];
-        coreConfig.types.auditableItemStreamComponent.push({
-            type: AuditableItemStreamComponentType.Service
-        });
-    }
-}
-/**
- * Configures the data processing.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureDataProcessing(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.dataProcessingEnabled) ?? false) {
-        coreConfig.types.dataProcessingComponent ??= [];
-        coreConfig.types.dataProcessingComponent.push({ type: DataProcessingComponentType.Service });
-        coreConfig.types.dataConverterConnector ??= [];
-        const converterConnectors = envVars.dataConverterConnectors?.split(",") ?? [];
-        for (const converterConnector of converterConnectors) {
-            if (converterConnector === DataConverterConnectorType.Json) {
-                coreConfig.types.dataConverterConnector.push({
-                    type: DataConverterConnectorType.Json
-                });
-            }
-            else if (converterConnector === DataConverterConnectorType.Xml) {
-                coreConfig.types.dataConverterConnector.push({
-                    type: DataConverterConnectorType.Xml
-                });
-            }
-        }
-        coreConfig.types.dataExtractorConnector ??= [];
-        const extractorConnectors = envVars.dataExtractorConnectors?.split(",") ?? [];
-        for (const extractorConnector of extractorConnectors) {
-            if (extractorConnector === DataExtractorConnectorType.JsonPath) {
-                coreConfig.types.dataExtractorConnector.push({
-                    type: DataExtractorConnectorType.JsonPath
-                });
-            }
-        }
-    }
-}
-/**
- * Configures the document management.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureDocumentManagement(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.documentManagementEnabled) ?? false) {
-        coreConfig.types.documentManagementComponent ??= [];
-        coreConfig.types.documentManagementComponent.push({
-            type: DocumentManagementComponentType.Service
-        });
-    }
-}
-/**
- * Configures the verifiable credential authentication.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureVerifiableCredentialAuthentication(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.vcAuthenticationEnabled) ?? false) {
-        // Can only perform VC authentication if identity component is available
-        coreConfig.types.authenticationGeneratorComponent ??= [];
-        coreConfig.types.authenticationGeneratorComponent.push({
-            type: AuthenticationGeneratorComponentType.VerifiableCredential,
-            options: {
-                config: {
-                    verificationMethodId: envVars.vcAuthenticationVerificationMethodId ?? VC_AUTHENTICATION_VERIFICATION_METHOD_ID
-                }
-            },
-            features: ["verifiable-credential"]
-        });
-    }
-}
-/**
- * Configures the rights management.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureRightsManagement(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.rightsManagementEnabled) ?? false) {
-        coreConfig.types.rightsManagementPapComponent ??= [];
-        coreConfig.types.rightsManagementPapComponent.push({
-            type: RightsManagementPapComponentType.Service
-        });
-        coreConfig.types.rightsManagementPmpComponent ??= [];
-        coreConfig.types.rightsManagementPmpComponent.push({
-            type: RightsManagementPmpComponentType.Service
-        });
-        coreConfig.types.rightsManagementPipComponent ??= [];
-        coreConfig.types.rightsManagementPipComponent.push({
-            type: RightsManagementPipComponentType.Service,
-            options: {
-                informationModulesConfig: Is.arrayValue(envVars.rightsManagementInformationSources)
-                    ? envVars.rightsManagementInformationSources
-                    : undefined
-            }
-        });
-        coreConfig.types.rightsManagementPxpComponent ??= [];
-        coreConfig.types.rightsManagementPxpComponent.push({
-            type: RightsManagementPxpComponentType.Service,
-            options: {
-                actionModulesConfig: Is.arrayValue(envVars.rightsManagementExecutionActions)
-                    ? envVars.rightsManagementExecutionActions
-                    : undefined
-            }
-        });
-        coreConfig.types.rightsManagementPdpComponent ??= [];
-        coreConfig.types.rightsManagementPdpComponent.push({
-            type: RightsManagementPdpComponentType.Service,
-            options: {
-                arbiterModulesConfig: Is.arrayValue(envVars.rightsManagementArbiters)
-                    ? envVars.rightsManagementArbiters
-                    : undefined
-            }
-        });
-        coreConfig.types.rightsManagementPepComponent ??= [];
-        coreConfig.types.rightsManagementPepComponent.push({
-            type: RightsManagementPepComponentType.Service,
-            options: {
-                processorModulesConfig: Is.arrayValue(envVars.rightsManagementEnforcementProcessors)
-                    ? envVars.rightsManagementEnforcementProcessors
-                    : undefined
-            }
-        });
-        coreConfig.types.rightsManagementPnpComponent ??= [];
-        coreConfig.types.rightsManagementPnpComponent.push({
-            type: RightsManagementPnpComponentType.Service,
-            options: {
-                negotiatorModulesConfig: Is.arrayValue(envVars.rightsManagementNegotiators)
-                    ? envVars.rightsManagementNegotiators
-                    : undefined,
-                requesterModulesConfig: Is.arrayValue(envVars.rightsManagementRequesters)
-                    ? envVars.rightsManagementRequesters
-                    : undefined,
-                config: {
-                    baseCallbackUrl: envVars.rightsManagementBaseCallbackUrl ?? "",
-                    offers: Is.arrayValue(envVars.rightsManagementOffers)
-                        ? envVars.rightsManagementOffers
-                        : [],
-                    negotiationComponentCreator: async (url) => new PolicyNegotiationPointRestClient({ endpoint: url })
-                }
-            }
-        });
-        coreConfig.types.rightsManagementPnapComponent ??= [];
-        coreConfig.types.rightsManagementPnapComponent.push({
-            type: RightsManagementPnapComponentType.Service
-        });
-        coreConfig.types.rightsManagementDapComponent ??= [];
-        coreConfig.types.rightsManagementDapComponent.push({
-            type: RightsManagementDapComponentType.Service
-        });
-        coreConfig.types.rightsManagementDarpComponent ??= [];
-        coreConfig.types.rightsManagementDarpComponent.push({
-            type: RightsManagementDarpComponentType.Service,
-            options: {
-                config: {
-                    dataAccessComponentCreator: async (url) => new DataAccessPointRestClient({ endpoint: url })
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the task scheduler.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureTaskScheduler(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.taskSchedulerEnabled) ?? false) {
-        coreConfig.types.taskSchedulerComponent ??= [];
-        coreConfig.types.taskSchedulerComponent.push({
-            type: TaskSchedulerComponentType.Service
-        });
-    }
-}
-/**
- * Configures the synchronised storage.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureSynchronisedStorage(coreConfig, envVars) {
-    if (Is.arrayValue(coreConfig.types.identityResolverComponent) &&
-        (Coerce.boolean(envVars.synchronisedStorageEnabled) ?? false)) {
-        // Check if the config provides a custom verifiable storage key id
-        let verifiableStorageKeyId = Coerce.string(envVars.synchronisedStorageVerifiableStorageKeyId);
-        if (!Is.stringValue(verifiableStorageKeyId)) {
-            // No custom key so default to the network setting
-            verifiableStorageKeyId = envVars.iotaNetwork;
-        }
-        coreConfig.types.synchronisedStorageComponent ??= [];
-        coreConfig.types.synchronisedStorageComponent.push({
-            type: SynchronisedStorageComponentType.Service,
-            options: {
-                config: {
-                    verifiableStorageKeyId: verifiableStorageKeyId ?? "",
-                    blobStorageEncryptionKeyId: envVars.synchronisedStorageBlobStorageEncryptionKeyId ??
-                        SYNCHRONISED_STORAGE_BLOB_STORAGE_ENCRYPTION_KEY_ID,
-                    entityUpdateIntervalMinutes: Coerce.number(envVars.synchronisedStorageEntityUpdateIntervalMinutes),
-                    consolidationIntervalMinutes: Coerce.number(envVars.synchronisedStorageConsolidationIntervalMinutes),
-                    consolidationBatchSize: Coerce.number(envVars.synchronisedStorageConsolidationBatchSize),
-                    maxConsolidations: Coerce.number(envVars.synchronisedStorageMaxConsolidations)
-                }
-            }
-        });
-        // If there is a trusted url set, we need to add a client
-        // and give it a feature of trusted so that when the synchronised
-        // storage is created it can pickup the correct component
-        if (Is.stringValue(envVars.synchronisedStorageTrustedUrl)) {
-            coreConfig.types.synchronisedStorageComponent.push({
-                type: SynchronisedStorageComponentType.RestClient,
-                options: {
-                    endpoint: envVars.synchronisedStorageTrustedUrl
-                },
-                features: ["trusted"]
-            });
-        }
-    }
-}
-/**
- * Configures the federated catalogue.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureFederatedCatalogue(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.federatedCatalogueEnabled) ?? false) {
-        coreConfig.types.federatedCatalogueComponent ??= [];
-        coreConfig.types.federatedCatalogueComponent.push({
-            type: FederatedCatalogueComponentType.Service,
-            options: {
-                config: {
-                    subResourceCacheTtlMs: Coerce.number(envVars.federatedCatalogueCacheTtlMs),
-                    clearingHouseApproverList: Coerce.object(envVars.federatedCatalogueClearingHouseApproverList) ?? []
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the data space connector.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureDataSpaceConnector(coreConfig, envVars) {
-    if (Coerce.boolean(envVars.dataSpaceConnectorEnabled) ?? false) {
-        coreConfig.types.dataSpaceConnectorComponent ??= [];
-        coreConfig.types.dataSpaceConnectorComponent.push({
-            type: DataSpaceConnectorComponentType.Service,
-            options: {
-                config: {
-                    retainActivityLogsFor: Coerce.number(envVars.dataSpaceConnectorRetainActivityLogsFor),
-                    activityLogsCleanUpInterval: Coerce.number(envVars.dataSpaceConnectorActivityLogsCleanUpInterval)
-                }
-            }
-        });
-    }
-}
-/**
- * Configures the DLT.
- * @param coreConfig The core config.
- * @param envVars The environment variables.
- */
-async function configureDlt(coreConfig, envVars) {
-    // Create centralized DLT configuration for IOTA if essential IOTA variables are set
-    if (Is.stringValue(envVars.iotaNodeEndpoint) && Is.stringValue(envVars.iotaNetwork)) {
-        coreConfig.types.dltConfig ??= [];
-        const gasStationConfig = Is.stringValue(envVars.iotaGasStationEndpoint) &&
-            Is.stringValue(envVars.iotaGasStationAuthToken)
-            ? {
-                gasStationUrl: envVars.iotaGasStationEndpoint,
-                gasStationAuthToken: envVars.iotaGasStationAuthToken
-            }
-            : undefined;
-        coreConfig.types.dltConfig.push({
-            type: DltConfigType.Iota,
-            isDefault: true,
-            options: {
-                config: {
-                    clientOptions: {
-                        url: envVars.iotaNodeEndpoint ?? ""
-                    },
-                    network: envVars.iotaNetwork ?? "",
-                    coinType: Coerce.number(envVars.iotaCoinType),
-                    gasStation: gasStationConfig
-                }
-            }
-        });
-    }
-}
-
-/**
- * Handles the configuration of the server.
- * @param envVars The environment variables for the engine server.
- * @param coreEngineConfig The core engine config.
- * @param serverInfo The server information.
- * @param openApiSpecPath The path to the open api spec.
- * @param favIconPath The path to the favicon.
- * @returns The config for the core and the server.
- */
-async function buildEngineServerConfiguration(envVars, coreEngineConfig, serverInfo, openApiSpecPath, favIconPath) {
-    const webServerOptions = {
-        port: Coerce.number(envVars.port),
-        host: Coerce.string(envVars.host),
-        methods: Is.stringValue(envVars.httpMethods)
-            ? envVars.httpMethods.split(",")
-            : undefined,
-        allowedHeaders: Is.stringValue(envVars.httpAllowedHeaders)
-            ? envVars.httpAllowedHeaders.split(",")
-            : undefined,
-        exposedHeaders: Is.stringValue(envVars.httpExposedHeaders)
-            ? envVars.httpExposedHeaders.split(",")
-            : undefined,
-        corsOrigins: Is.stringValue(envVars.corsOrigins) ? envVars.corsOrigins.split(",") : undefined
-    };
-    const serverConfig = {
-        ...coreEngineConfig,
-        web: webServerOptions,
-        types: {
-            ...coreEngineConfig.types,
-            informationComponent: [
-                {
-                    type: InformationComponentType.Service,
-                    options: {
-                        config: {
-                            serverInfo,
-                            openApiSpecPath,
-                            favIconPath
-                        }
-                    }
-                }
-            ]
-        }
-    };
-    if (Is.stringValue(envVars.mimeTypeProcessors)) {
-        const mimeTypeProcessors = envVars.mimeTypeProcessors.split(",");
-        if (Is.arrayValue(mimeTypeProcessors)) {
-            serverConfig.types.mimeTypeProcessor ??= [];
-            for (const mimeTypeProcessor of mimeTypeProcessors) {
-                serverConfig.types.mimeTypeProcessor.push({
-                    type: mimeTypeProcessor
-                });
-            }
-        }
-    }
-    serverConfig.types.restRouteProcessor ??= [];
-    serverConfig.types.socketRouteProcessor ??= [];
-    const features = getFeatures(envVars);
-    const hasNodeIdentity = features.includes(NodeFeatures.NodeIdentity);
-    if (hasNodeIdentity) {
-        serverConfig.types.restRouteProcessor.push({
-            type: RestRouteProcessorType.NodeIdentity
-        });
-        serverConfig.types.socketRouteProcessor.push({
-            type: SocketRouteProcessorType.NodeIdentity
-        });
-    }
-    if (!coreEngineConfig.silent) {
-        const includeBody = Coerce.boolean(envVars.routeLoggingIncludeBody) ?? coreEngineConfig.debug;
-        const fullBase64 = Coerce.boolean(envVars.routeLoggingFullBase64) ?? false;
-        const obfuscateProperties = Is.stringValue(envVars.routeLoggingObfuscateProperties)
-            ? envVars.routeLoggingObfuscateProperties.split(",")
-            : undefined;
-        serverConfig.types.restRouteProcessor.push({
-            type: RestRouteProcessorType.Logging,
-            options: {
-                config: {
-                    includeBody,
-                    fullBase64,
-                    obfuscateProperties
-                }
-            }
-        });
-        serverConfig.types.socketRouteProcessor.push({
-            type: SocketRouteProcessorType.Logging,
-            options: {
-                config: {
-                    includeBody,
-                    fullBase64,
-                    obfuscateProperties
-                }
-            }
-        });
-    }
-    serverConfig.types.restRouteProcessor.push({
-        type: RestRouteProcessorType.RestRoute,
-        options: {
-            config: {
-                includeErrorStack: coreEngineConfig.debug
-            }
-        }
-    });
-    serverConfig.types.socketRouteProcessor.push({
-        type: SocketRouteProcessorType.SocketRoute,
-        options: {
-            config: {
-                includeErrorStack: coreEngineConfig.debug
-            }
-        }
-    });
-    const authAdminProcessorType = envVars.authAdminProcessorType;
-    if (authAdminProcessorType === AuthenticationAdminComponentType.EntityStorage) {
-        serverConfig.types.authenticationAdminComponent ??= [];
-        serverConfig.types.authenticationAdminComponent.push({
-            type: AuthenticationAdminComponentType.EntityStorage,
-            options: {
-                config: {}
-            }
-        });
-    }
-    const authProcessorType = envVars.authProcessorType;
-    if (authProcessorType === AuthenticationComponentType.EntityStorage) {
-        serverConfig.types.authenticationComponent ??= [];
-        serverConfig.types.authenticationComponent.push({
-            type: AuthenticationComponentType.EntityStorage,
-            options: {
-                config: {
-                    signingKeyName: envVars.authSigningKeyId ?? AUTH_SIGNING_KEY_ID
-                }
-            }
-        });
-        serverConfig.types.restRouteProcessor.push({
-            type: RestRouteProcessorType.AuthHeader,
-            options: {
-                config: {
-                    signingKeyName: envVars.authSigningKeyId ?? AUTH_SIGNING_KEY_ID
-                }
-            }
-        });
-        serverConfig.types.socketRouteProcessor.push({
-            type: SocketRouteProcessorType.AuthHeader,
-            options: {
-                config: {
-                    signingKeyName: envVars.authSigningKeyId ?? AUTH_SIGNING_KEY_ID
-                }
-            }
-        });
-    }
-    if (Coerce.boolean(envVars.vcAuthenticationEnabled) ?? false) {
-        serverConfig.types.restRouteProcessor.push({
-            type: RestRouteProcessorType.AuthVerifiableCredential
-        });
-        serverConfig.types.socketRouteProcessor.push({
-            type: SocketRouteProcessorType.AuthVerifiableCredential
-        });
-    }
-    addDefaultRestPaths(serverConfig);
-    addDefaultSocketPaths(serverConfig);
-    return serverConfig;
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Handles the configuration of the extensions.
- * @param envVars The environment variables for the node.
- * @param nodeEngineConfig The node engine config.
- * @returns The config for the core and the server.
- */
-async function extensionsConfiguration(envVars, nodeEngineConfig) {
-    if (Is.stringValue(envVars.extensions)) {
-        const extensions = envVars.extensions.split(",");
-        for (const extension of extensions) {
-            let initialiseConfigMethod;
-            try {
-                CLIDisplay.value(I18n.formatMessage("node.extensionLoading"), extension);
-                initialiseConfigMethod = await ModuleHelper.getModuleMethod(extension, "extensionInitialise");
-            }
-            catch (err) {
-                throw new GeneralError("node", "extensionLoadingError", { extension }, err);
-            }
-            if (Is.function(initialiseConfigMethod)) {
-                await initialiseConfigMethod(envVars, nodeEngineConfig);
-            }
-        }
-    }
-    return nodeEngineConfig;
-}
-/**
- * Handles the initialisation of the extensions when the engine has been constructed.
- * @param envVars The environment variables for the node.
- * @param engineCore The engine core instance.
- * @returns Nothing.
- */
-async function extensionsInitialiseEngine(envVars, engineCore) {
-    if (Is.stringValue(envVars.extensions)) {
-        const extensions = envVars.extensions.split(",");
-        for (const extension of extensions) {
-            let initialiseEngineMethod;
-            try {
-                engineCore.logInfo(I18n.formatMessage("node.extensionInitialisingEngine", { extension }));
-                initialiseEngineMethod =
-                    await ModuleHelper.getModuleMethod(extension, "extensionInitialiseEngine");
-            }
-            catch { }
-            if (Is.function(initialiseEngineMethod)) {
-                await initialiseEngineMethod(engineCore);
-            }
-        }
-    }
-}
-/**
- * Handles the initialisation of the extensions when the engine server has been constructed.
- * @param envVars The environment variables for the node.
- * @param engineCore The engine core instance.
- * @param engineServer The engine server instance.
- * @returns Nothing.
- */
-async function extensionsInitialiseEngineServer(envVars, engineCore, engineServer) {
-    if (Is.stringValue(envVars.extensions)) {
-        const extensions = envVars.extensions.split(",");
-        for (const extension of extensions) {
-            let initialiseEngineServerMethod;
-            try {
-                engineCore.logInfo(I18n.formatMessage("node.extensionInitialisingEngineServer", { extension }));
-                initialiseEngineServerMethod =
-                    await ModuleHelper.getModuleMethod(extension, "extensionInitialiseEngineServer");
-            }
-            catch { }
-            if (Is.function(initialiseEngineServerMethod)) {
-                await initialiseEngineServerMethod(engineCore, engineServer);
-            }
-        }
-    }
-}
-/**
- * Handles the shutdown of the extensions.
- * @param envVars The environment variables for the node.
- * @param engineCore The engine core instance.
- * @returns Nothing.
- */
-async function shutdownExtensions(envVars, engineCore) {
-    if (Is.stringValue(envVars.extensions)) {
-        const extensions = envVars.extensions.split(",");
-        for (const extension of extensions) {
-            let shutdownMethod;
-            try {
-                engineCore.logInfo(I18n.formatMessage("node.extensionShutdown", { extension }));
-                shutdownMethod = await ModuleHelper.getModuleMethod(extension, "extensionShutdown");
-            }
-            catch { }
-            if (Is.function(shutdownMethod)) {
-                await shutdownMethod();
-            }
-        }
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Start the engine server.
- * @param nodeOptions Optional run options for the engine server.
- * @param nodeEngineConfig The configuration for the engine server.
- * @param envVars The environment variables.
- * @returns The engine server.
- */
-async function start(nodeOptions, nodeEngineConfig, envVars) {
-    const entityStorageConnectorType = envVars.entityStorageConnectorType?.split(",") ?? [];
-    const blobStorageConnectorType = envVars.blobStorageConnectorType?.split(",") ?? [];
-    // If the blob storage or entity storage is configured with file connectors
-    // then we need to make sure the storageFileRoot is set
-    if ((entityStorageConnectorType.includes(EntityStorageConnectorType.File) ||
-        blobStorageConnectorType.includes(BlobStorageConnectorType.File) ||
-        Is.empty(nodeOptions?.stateStorage)) &&
-        !Is.stringValue(envVars.storageFileRoot)) {
-        throw new GeneralError("node", "storageFileRootNotSet", {
-            storageFileRoot: `${nodeOptions?.envPrefix ?? ""}_STORAGE_FILE_ROOT`
-        });
-    }
-    // Create the engine instance using file state storage unless one is configured in options
-    const engine = new Engine({
-        config: nodeEngineConfig,
-        stateStorage: nodeOptions?.stateStorage ?? new FileStateStorage(envVars.stateFilename ?? ""),
-        customBootstrap: async (core, engineContext) => bootstrap(core, engineContext, envVars)
-    });
-    // Construct the server with the engine.
-    const server = new EngineServer({ engineCore: engine });
-    // Extend the engine.
-    if (Is.function(nodeOptions?.extendEngine)) {
-        engine.logInfo(I18n.formatMessage("node.extendingEngine"));
-        await nodeOptions.extendEngine(engine);
-    }
-    await extensionsInitialiseEngine(envVars, engine);
-    // Extend the engine server.
-    if (Is.function(nodeOptions?.extendEngineServer)) {
-        engine.logInfo(I18n.formatMessage("node.extendingEngineServer"));
-        await nodeOptions?.extendEngineServer(server);
-    }
-    await extensionsInitialiseEngineServer(envVars, engine, server);
-    // Need to register the engine with the factory so that background tasks
-    // can clone it to spawn new instances.
-    EngineCoreFactory.register("engine", () => engine);
-    // Start the server, which also starts the engine.
-    const canContinue = await server.start();
-    if (canContinue) {
-        return {
-            engine,
-            server,
-            shutdown: async () => {
-                await server.stop();
-                await shutdownExtensions(envVars, engine);
-            }
-        };
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-const moduleCache = {};
-/**
- * Run the TWIN Node server.
- * @param nodeOptions Optional configuration options for running the server.
- * @returns A promise that resolves when the server is started.
- */
-async function run(nodeOptions) {
-    try {
-        nodeOptions ??= {};
-        const serverInfo = {
-            name: nodeOptions?.serverName ?? "TWIN Node Server",
-            version: nodeOptions?.serverVersion ?? "0.0.2-next.26" // x-release-please-version
-        };
-        CLIDisplay.header(serverInfo.name, serverInfo.version, "🌩️ ");
-        if (!Is.stringValue(nodeOptions?.executionDirectory)) {
-            nodeOptions.executionDirectory = getExecutionDirectory();
-        }
-        CLIDisplay.value("Execution Directory", nodeOptions.executionDirectory);
-        nodeOptions.localesDirectory =
-            nodeOptions?.localesDirectory ??
-                path.resolve(path.join(nodeOptions.executionDirectory, "dist", "locales"));
-        CLIDisplay.value("Locales Directory", nodeOptions.localesDirectory);
-        await initialiseLocales(nodeOptions.localesDirectory);
-        if (Is.empty(nodeOptions?.openApiSpecFile)) {
-            const specFile = path.resolve(path.join(nodeOptions.executionDirectory ?? "", "docs", "open-api", "spec.json"));
-            CLIDisplay.value("Default OpenAPI Spec File", specFile);
-            if (await fileExists(specFile)) {
-                nodeOptions ??= {};
-                nodeOptions.openApiSpecFile = specFile;
-            }
-        }
-        else {
-            CLIDisplay.value("OpenAPI Spec File", nodeOptions.openApiSpecFile);
-        }
-        if (Is.empty(nodeOptions?.favIconFile)) {
-            const favIconFile = path.resolve(path.join(nodeOptions.executionDirectory ?? "", "static", "favicon.png"));
-            CLIDisplay.value("Default Favicon File", favIconFile);
-            if (await fileExists(favIconFile)) {
-                nodeOptions ??= {};
-                nodeOptions.favIconFile = favIconFile;
-            }
-        }
-        else {
-            CLIDisplay.value("Favicon File", nodeOptions.favIconFile);
-        }
-        nodeOptions.envPrefix ??= "TWIN_NODE_";
-        CLIDisplay.value("Environment Variable Prefix", nodeOptions.envPrefix);
-        overrideModuleImport(nodeOptions.executionDirectory ?? "");
-        const { nodeEngineConfig, nodeEnvVars: envVars } = await buildConfiguration(
-        // This is the only location in the code base that should access process.env directly
-        // So we can safely disable the linting rule here.
-        // eslint-disable-next-line no-restricted-syntax
-        process.env, nodeOptions, serverInfo);
-        CLIDisplay.break();
-        const startResult = await start(nodeOptions, nodeEngineConfig, envVars);
-        if (!Is.empty(startResult)) {
-            for (const signal of ["SIGHUP", "SIGINT", "SIGTERM"]) {
-                process.on(signal, async () => {
-                    CLIDisplay.value("Terminate Signal", signal);
-                    await startResult.shutdown();
-                });
-            }
-        }
-    }
-    catch (err) {
-        CLIDisplay.error(err);
-        // eslint-disable-next-line unicorn/no-process-exit
-        process.exit(1);
-    }
-}
-/**
- * Build the configuration for the TWIN Node server.
- * @param processEnv The environment variables from the process.
- * @param options The options for running the server.
- * @param serverInfo The server information.
- * @returns A promise that resolves to the engine server configuration, environment prefix, environment variables,
- * and options.
- */
-async function buildConfiguration(processEnv, options, serverInfo) {
-    let defaultEnvOnly = false;
-    if (Is.empty(options?.envFilenames)) {
-        const envFile = path.resolve(path.join(options.executionDirectory ?? "", ".env"));
-        CLIDisplay.value("Default Environment File", envFile);
-        options ??= {};
-        options.envFilenames = [envFile];
-        defaultEnvOnly = true;
-    }
-    if (Is.arrayValue(options?.envFilenames)) {
-        const output = dotenv.config({
-            path: options?.envFilenames,
-            quiet: true
-        });
-        // We don't want to throw an error if the default environment file is not found.
-        // Only if we have custom environment files.
-        if (!defaultEnvOnly && output.error) {
-            throw output.error;
-        }
-        if (Is.objectValue(output.parsed)) {
-            Object.assign(processEnv, output.parsed);
-        }
-    }
-    const envVars = EnvHelper.envToJson(processEnv, options.envPrefix ?? "");
-    // Expand any environment variables that use the @file: syntax
-    const keys = Object.keys(envVars);
-    for (const key of keys) {
-        if (Is.stringValue(envVars[key]) &&
-            (envVars[key].startsWith("@text:") || envVars[key].startsWith("@json:"))) {
-            const filePath = envVars[key].slice(6).trim();
-            const embeddedFile = path.resolve(path.join(options.executionDirectory ?? "", filePath));
-            if (envVars[key].startsWith("@text:")) {
-                CLIDisplay.value(`Expanding Environment Variable: ${key} from text file`, embeddedFile);
-                envVars[key] = await loadTextFile(embeddedFile);
-            }
-            else if (envVars[key].startsWith("@json:")) {
-                CLIDisplay.value(`Expanding Environment Variable: ${key} from JSON file`, embeddedFile);
-                envVars[key] = await loadJsonFile(embeddedFile);
-            }
-        }
-    }
-    // Extend the environment variables with any additional custom configuration.
-    if (Is.function(options?.extendEnvVars)) {
-        CLIDisplay.task("Extending Environment Variables");
-        await options.extendEnvVars(envVars);
-    }
-    // Build the engine configuration from the environment variables.
-    const coreConfig = await buildEngineConfiguration(envVars);
-    const engineServerConfig = await buildEngineServerConfiguration(envVars, coreConfig, serverInfo, options?.openApiSpecFile, options?.favIconFile);
-    // Merge any custom configuration provided in the options.
-    if (Is.arrayValue(options?.configFilenames)) {
-        for (const configFile of options.configFilenames) {
-            CLIDisplay.value("Loading Configuration File", configFile);
-            const configFilePath = path.resolve(path.join(options.executionDirectory ?? "", configFile));
-            const config = await loadJsonFile(configFilePath);
-            Object.assign(engineServerConfig, config);
-        }
-    }
-    if (Is.objectValue(options?.config)) {
-        CLIDisplay.task("Merging Custom Configuration");
-        Object.assign(engineServerConfig, options.config);
-    }
-    // Merge any custom configuration provided in the options.
-    if (Is.function(options?.extendConfig)) {
-        CLIDisplay.task("Extending Configuration");
-        await options.extendConfig(envVars, engineServerConfig);
-    }
-    const nodeEngineConfig = await extensionsConfiguration(envVars, engineServerConfig);
-    return { nodeEngineConfig, nodeEnvVars: envVars };
-}
-/**
- * Override module imports to support protocol-based loading (npm:, https:) and local files.
- * @param executionDirectory The execution directory for resolving local module paths.
- * @param envVars The environment variables containing extension configuration (optional, uses defaults if not provided).
- */
-function overrideModuleImport(executionDirectory, envVars) {
-    const maxSizeMb = Coerce.number(envVars?.extensionsMaxSizeMb) ?? 10;
-    const cacheDirectory = envVars?.extensionsCacheDirectory;
-    ModuleHelper.overrideImport(async (moduleName) => {
-        if (moduleCache[moduleName]) {
-            return {
-                module: moduleCache[moduleName],
-                useDefault: false
-            };
-        }
-        const parsed = parseModuleProtocol(moduleName);
-        let resolvedPath;
-        switch (parsed.protocol) {
-            case ModuleProtocol.Npm: {
-                const result = await handleNpmProtocol(parsed.identifier, executionDirectory, cacheDirectory);
-                resolvedPath = result.resolvedPath;
-                break;
-            }
-            case ModuleProtocol.Https: {
-                const result = await handleHttpsProtocol(parsed.identifier, executionDirectory, maxSizeMb, cacheDirectory, envVars?.extensionsCacheTtlHours, envVars?.extensionsForceRefresh);
-                resolvedPath = result.resolvedPath;
-                break;
-            }
-            case ModuleProtocol.Http: {
-                throw new GeneralError("node", "insecureProtocol", { protocol: ModuleProtocol.Http });
-            }
-            case ModuleProtocol.Local: {
-                let localFilename = path.resolve(moduleName);
-                let exists = await fileExists(localFilename);
-                if (!exists) {
-                    localFilename = path.resolve(executionDirectory, moduleName);
-                    exists = await fileExists(localFilename);
-                }
-                if (exists) {
-                    resolvedPath = localFilename;
-                }
-                break;
-            }
-            case ModuleProtocol.Default: {
-                try {
-                    const npmRoot = execSync("npm root").toString().trim().replace(/\\/g, "/");
-                    const packagePath = path.resolve(npmRoot, moduleName);
-                    const mainFile = await resolvePackageEntryPoint(packagePath, moduleName);
-                    const modulePath = path.resolve(packagePath, mainFile);
-                    const exists = await fileExists(modulePath);
-                    if (exists) {
-                        resolvedPath = modulePath;
-                        break;
-                    }
-                }
-                catch {
-                    // Continue to fallback resolution
-                }
-                // Fallback: resolve from npm protocol cache directory (installed via handleNpmProtocol)
-                try {
-                    const cacheNpmRoot = path.resolve(getExtensionsCacheDir(executionDirectory, ModuleProtocol.Npm, cacheDirectory), "node_modules");
-                    const packagePath = path.resolve(cacheNpmRoot, moduleName);
-                    const mainFile = await resolvePackageEntryPoint(packagePath, moduleName);
-                    const modulePath = path.resolve(packagePath, mainFile);
-                    const exists = await fileExists(modulePath);
-                    if (exists) {
-                        resolvedPath = modulePath;
-                    }
-                }
-                catch {
-                    // No cached resolution either; fall through
-                }
-                break;
-            }
-        }
-        // Common module loading and caching logic
-        if (resolvedPath) {
-            const module = await import(createModuleImportUrl(resolvedPath));
-            moduleCache[moduleName] = module;
-            return {
-                module,
-                useDefault: false
-            };
-        }
-        return {
-            module: undefined,
-            useDefault: true
-        };
-    });
-}
-
-export { ATTESTATION_VERIFICATION_METHOD_ID, AUTH_SIGNING_KEY_ID, BLOB_STORAGE_ENCRYPTION_KEY_ID, IMMUTABLE_PROOF_VERIFICATION_METHOD_ID, ModuleProtocol, NodeFeatures, SYNCHRONISED_STORAGE_BLOB_STORAGE_ENCRYPTION_KEY_ID, VC_AUTHENTICATION_VERIFICATION_METHOD_ID, bootstrap, bootstrapAuth, bootstrapBlobEncryption, bootstrapImmutableProofMethod, bootstrapNodeIdentity, bootstrapNodeUser, bootstrapSynchronisedStorage, buildConfiguration, buildEngineConfiguration, buildEngineServerConfiguration, createModuleImportUrl, directoryExists, extensionsConfiguration, extensionsInitialiseEngine, extensionsInitialiseEngineServer, fileExists, getExecutionDirectory, getExtensionsCacheDir, getFeatures, getFiles, getSubFolders, handleHttpsProtocol, handleNpmProtocol, hashUrl, initialiseLocales, isCacheExpired, loadJsonFile, loadTextFile, overrideModuleImport, parseModuleProtocol, resolvePackageEntryPoint, run, shutdownExtensions, start };