@twin.org/node-core 0.0.1 → 0.0.2-next.2

package/dist/cjs/index.cjs

@@ -10,9 +10,9 @@ var vaultModels = require('@twin.org/vault-models');
 var walletModels = require('@twin.org/wallet-models');
 var promises = require('node:fs/promises');
 var path = require('node:path');
-var dotenv = require('dotenv');
 var engineServer = require('@twin.org/engine-server');
 var engineServerTypes = require('@twin.org/engine-server-types');
+var dotenv = require('dotenv');
 var engine = require('@twin.org/engine');
 var engineCore = require('@twin.org/engine-core');
 var engineModels = require('@twin.org/engine-models');
@@ -581,14 +581,13 @@ function getIotaConfig(coreConfig) {
 function configureEntityStorage(coreConfig, envVars) {
     coreConfig.types ??= {};
     coreConfig.types.entityStorageConnector ??= [];
-    if ((core.Coerce.boolean(envVars.entityMemoryEnable) ?? false) ||
-        envVars.entityStorageConnectorType === engineTypes.EntityStorageConnectorType.Memory) {
+    const entityStorageConnectorTypes = envVars.entityStorageConnectorType?.split(",") ?? [];
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.Memory)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.Memory
         });
     }
-    if ((core.Coerce.boolean(envVars.entityFileEnable) ?? false) ||
-        envVars.entityStorageConnectorType === engineTypes.EntityStorageConnectorType.File) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.File)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.File,
             options: {
@@ -597,7 +596,7 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.awsDynamodbAccessKeyId)) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.AwsDynamoDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.AwsDynamoDb,
             options: {
@@ -611,7 +610,7 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.azureCosmosdbKey)) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.AzureCosmosDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.AzureCosmosDb,
             options: {
@@ -625,7 +624,7 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.gcpFirestoreCredentials)) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.GcpFirestoreDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.GcpFirestoreDb,
             options: {
@@ -640,26 +639,27 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.scylladbHosts)) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.ScyllaDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.ScyllaDb,
             options: {
                 config: {
-                    hosts: envVars.scylladbHosts.split(",") ?? "",
+                    hosts: envVars.scylladbHosts?.split(",") ?? [],
                     localDataCenter: envVars.scylladbLocalDataCenter ?? "",
-                    keyspace: envVars.scylladbKeyspace ?? ""
+                    keyspace: envVars.scylladbKeyspace ?? "",
+                    port: core.Coerce.integer(envVars.scylladbPort)
                 },
                 tablePrefix: envVars.entityStorageTablePrefix
             }
         });
     }
-    if (core.Is.stringValue(envVars.mySqlHost)) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.MySqlDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.MySqlDb,
             options: {
                 config: {
-                    host: envVars.mySqlHost,
-                    port: envVars.mySqlPort ?? 3306,
+                    host: envVars.mySqlHost ?? "",
+                    port: core.Coerce.integer(envVars.mySqlPort),
                     user: envVars.mySqlUser ?? "",
                     password: envVars.mySqlPassword ?? "",
                     database: envVars.mySqlDatabase ?? ""
@@ -668,28 +668,13 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.mySqlHost)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: engineTypes.EntityStorageConnectorType.MySqlDb,
-            options: {
-                config: {
-                    host: envVars.mySqlHost,
-                    port: envVars.mySqlPort ?? 3306,
-                    user: envVars.mySqlUser ?? "",
-                    password: envVars.mySqlPassword ?? "",
-                    database: envVars.mySqlDatabase ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (core.Is.stringValue(envVars.mongoDbHost)) {
+    if (entityStorageConnectorTypes.includes(engineTypes.EntityStorageConnectorType.MongoDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.MongoDb,
             options: {
                 config: {
-                    host: envVars.mongoDbHost,
-                    port: envVars.mongoDbPort,
+                    host: envVars.mongoDbHost ?? "",
+                    port: core.Coerce.integer(envVars.mongoDbPort),
                     user: envVars.mongoDbUser ?? "",
                     password: envVars.mongoDbPassword ?? "",
                     database: envVars.mongoDbDatabase ?? ""
@@ -698,13 +683,13 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.postgreSqlHost)) {
+    if (entityStorageConnectorTypes) {
         coreConfig.types.entityStorageConnector.push({
             type: engineTypes.EntityStorageConnectorType.PostgreSql,
             options: {
                 config: {
-                    host: envVars.postgreSqlHost,
-                    port: envVars.postgreSqlPort,
+                    host: envVars.postgreSqlHost ?? "",
+                    port: core.Coerce.integer(envVars.postgreSqlPort),
                     user: envVars.postgreSqlUser ?? "",
                     password: envVars.postgreSqlPassword ?? "",
                     database: envVars.postgreSqlDatabase ?? ""
@@ -713,11 +698,12 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    const defaultStorageConnector = envVars.entityStorageConnectorType;
-    if (core.Is.stringValue(defaultStorageConnector)) {
+    if (core.Is.arrayValue(entityStorageConnectorTypes)) {
+        const defaultStorageConnectorType = envVars.entityStorageConnectorDefault ?? entityStorageConnectorTypes[0];
         for (const config of coreConfig.types.entityStorageConnector) {
-            if (config.type === defaultStorageConnector) {
+            if (config.type === defaultStorageConnectorType) {
                 config.isDefault = true;
+                break;
             }
         }
     }
@@ -729,14 +715,13 @@ function configureEntityStorage(coreConfig, envVars) {
  */
 function configureBlobStorage(coreConfig, envVars) {
     coreConfig.types.blobStorageConnector ??= [];
-    if ((core.Coerce.boolean(envVars.blobMemoryEnable) ?? false) ||
-        envVars.blobStorageConnectorType === engineTypes.BlobStorageConnectorType.Memory) {
+    const blobStorageConnectorTypes = envVars.blobStorageConnectorType?.split(",") ?? [];
+    if (blobStorageConnectorTypes.includes(engineTypes.BlobStorageConnectorType.Memory)) {
         coreConfig.types.blobStorageConnector.push({
             type: engineTypes.BlobStorageConnectorType.Memory
         });
     }
-    if ((core.Coerce.boolean(envVars.blobFileEnable) ?? false) ||
-        envVars.blobStorageConnectorType === engineTypes.BlobStorageConnectorType.File) {
+    if (blobStorageConnectorTypes.includes(engineTypes.BlobStorageConnectorType.File)) {
         coreConfig.types.blobStorageConnector.push({
             type: engineTypes.BlobStorageConnectorType.File,
             options: {
@@ -749,18 +734,18 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.ipfsApiUrl)) {
+    if (blobStorageConnectorTypes.includes(engineTypes.BlobStorageConnectorType.Ipfs)) {
         coreConfig.types.blobStorageConnector.push({
             type: engineTypes.BlobStorageConnectorType.Ipfs,
             options: {
                 config: {
-                    apiUrl: envVars.ipfsApiUrl,
+                    apiUrl: envVars.ipfsApiUrl ?? "",
                     bearerToken: envVars.ipfsBearerToken
                 }
             }
         });
     }
-    if (core.Is.stringValue(envVars.awsS3AccessKeyId)) {
+    if (blobStorageConnectorTypes.includes(engineTypes.BlobStorageConnectorType.AwsS3)) {
         coreConfig.types.blobStorageConnector.push({
             type: engineTypes.BlobStorageConnectorType.AwsS3,
             options: {
@@ -775,7 +760,7 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.azureStorageAccountKey)) {
+    if (blobStorageConnectorTypes.includes(engineTypes.BlobStorageConnectorType.AzureStorage)) {
         coreConfig.types.blobStorageConnector.push({
             type: engineTypes.BlobStorageConnectorType.AzureStorage,
             options: {
@@ -789,7 +774,7 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    if (core.Is.stringValue(envVars.gcpStorageCredentials)) {
+    if (blobStorageConnectorTypes.includes(engineTypes.BlobStorageConnectorType.GcpStorage)) {
         coreConfig.types.blobStorageConnector.push({
             type: engineTypes.BlobStorageConnectorType.GcpStorage,
             options: {
@@ -803,11 +788,12 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    const defaultStorageConnectorType = envVars.blobStorageConnectorType;
-    if (core.Is.stringValue(defaultStorageConnectorType)) {
+    if (core.Is.arrayValue(blobStorageConnectorTypes)) {
+        const defaultStorageConnectorType = envVars.blobStorageConnectorDefault ?? blobStorageConnectorTypes[0];
         for (const config of coreConfig.types.blobStorageConnector) {
             if (config.type === defaultStorageConnectorType) {
                 config.isDefault = true;
+                break;
             }
         }
     }
@@ -1547,8 +1533,10 @@ function buildEngineServerConfiguration(envVars, coreEngineConfig, serverInfo, o
  */
 async function start(nodeOptions, engineServerConfig, envVars) {
     envVars.storageFileRoot ??= "";
-    if ((envVars.entityStorageConnectorType === engineTypes.EntityStorageConnectorType.File ||
-        envVars.blobStorageConnectorType === engineTypes.BlobStorageConnectorType.File ||
+    const entityStorageConnectorType = envVars.entityStorageConnectorType?.split(",") ?? [];
+    const blobStorageConnectorType = envVars.blobStorageConnectorType?.split(",") ?? [];
+    if ((entityStorageConnectorType.includes(engineTypes.EntityStorageConnectorType.File) ||
+        blobStorageConnectorType.includes(engineTypes.BlobStorageConnectorType.File) ||
         core.Is.empty(nodeOptions?.stateStorage)) &&
         !core.Is.stringValue(envVars.storageFileRoot)) {
         throw new core.GeneralError("node", "storageFileRootNotSet", {
@@ -1599,7 +1587,7 @@ async function run(nodeOptions) {
         nodeOptions ??= {};
         const serverInfo = {
             name: nodeOptions?.serverName ?? "TWIN Node Server",
-            version: nodeOptions?.serverVersion ?? "0.0.1-next.11" // x-release-please-version
+            version: nodeOptions?.serverVersion ?? "0.0.2-next.2" // x-release-please-version
         };
         console.log(`\u001B[4m🌩️  ${serverInfo.name} v${serverInfo.version}\u001B[24m\n`);
         if (!core.Is.stringValue(nodeOptions?.executionDirectory)) {
@@ -1719,6 +1707,7 @@ exports.bootstrapNodeIdentity = bootstrapNodeIdentity;
 exports.bootstrapNodeUser = bootstrapNodeUser;
 exports.buildConfiguration = buildConfiguration;
 exports.buildEngineConfiguration = buildEngineConfiguration;
+exports.buildEngineServerConfiguration = buildEngineServerConfiguration;
 exports.fileExists = fileExists;
 exports.getExecutionDirectory = getExecutionDirectory;
 exports.getFeatures = getFeatures;

package/dist/esm/index.mjs

@@ -8,9 +8,9 @@ import { VaultConnectorFactory, VaultKeyType } from '@twin.org/vault-models';
 import { WalletConnectorFactory } from '@twin.org/wallet-models';
 import { readFile, stat } from 'node:fs/promises';
 import path from 'node:path';
-import * as dotenv from 'dotenv';
 import { addDefaultRestPaths, addDefaultSocketPaths, EngineServer } from '@twin.org/engine-server';
 import { InformationComponentType, RestRouteProcessorType, SocketRouteProcessorType, AuthenticationAdminComponentType, AuthenticationComponentType } from '@twin.org/engine-server-types';
+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';
@@ -560,14 +560,13 @@ function getIotaConfig(coreConfig) {
 function configureEntityStorage(coreConfig, envVars) {
     coreConfig.types ??= {};
     coreConfig.types.entityStorageConnector ??= [];
-    if ((Coerce.boolean(envVars.entityMemoryEnable) ?? false) ||
-        envVars.entityStorageConnectorType === EntityStorageConnectorType.Memory) {
+    const entityStorageConnectorTypes = envVars.entityStorageConnectorType?.split(",") ?? [];
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.Memory)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.Memory
         });
     }
-    if ((Coerce.boolean(envVars.entityFileEnable) ?? false) ||
-        envVars.entityStorageConnectorType === EntityStorageConnectorType.File) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.File)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.File,
             options: {
@@ -576,7 +575,7 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.awsDynamodbAccessKeyId)) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.AwsDynamoDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.AwsDynamoDb,
             options: {
@@ -590,7 +589,7 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.azureCosmosdbKey)) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.AzureCosmosDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.AzureCosmosDb,
             options: {
@@ -604,7 +603,7 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.gcpFirestoreCredentials)) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.GcpFirestoreDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.GcpFirestoreDb,
             options: {
@@ -619,26 +618,27 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.scylladbHosts)) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.ScyllaDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.ScyllaDb,
             options: {
                 config: {
-                    hosts: envVars.scylladbHosts.split(",") ?? "",
+                    hosts: envVars.scylladbHosts?.split(",") ?? [],
                     localDataCenter: envVars.scylladbLocalDataCenter ?? "",
-                    keyspace: envVars.scylladbKeyspace ?? ""
+                    keyspace: envVars.scylladbKeyspace ?? "",
+                    port: Coerce.integer(envVars.scylladbPort)
                 },
                 tablePrefix: envVars.entityStorageTablePrefix
             }
         });
     }
-    if (Is.stringValue(envVars.mySqlHost)) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.MySqlDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.MySqlDb,
             options: {
                 config: {
-                    host: envVars.mySqlHost,
-                    port: envVars.mySqlPort ?? 3306,
+                    host: envVars.mySqlHost ?? "",
+                    port: Coerce.integer(envVars.mySqlPort),
                     user: envVars.mySqlUser ?? "",
                     password: envVars.mySqlPassword ?? "",
                     database: envVars.mySqlDatabase ?? ""
@@ -647,28 +647,13 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.mySqlHost)) {
-        coreConfig.types.entityStorageConnector.push({
-            type: EntityStorageConnectorType.MySqlDb,
-            options: {
-                config: {
-                    host: envVars.mySqlHost,
-                    port: envVars.mySqlPort ?? 3306,
-                    user: envVars.mySqlUser ?? "",
-                    password: envVars.mySqlPassword ?? "",
-                    database: envVars.mySqlDatabase ?? ""
-                },
-                tablePrefix: envVars.entityStorageTablePrefix
-            }
-        });
-    }
-    if (Is.stringValue(envVars.mongoDbHost)) {
+    if (entityStorageConnectorTypes.includes(EntityStorageConnectorType.MongoDb)) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.MongoDb,
             options: {
                 config: {
-                    host: envVars.mongoDbHost,
-                    port: envVars.mongoDbPort,
+                    host: envVars.mongoDbHost ?? "",
+                    port: Coerce.integer(envVars.mongoDbPort),
                     user: envVars.mongoDbUser ?? "",
                     password: envVars.mongoDbPassword ?? "",
                     database: envVars.mongoDbDatabase ?? ""
@@ -677,13 +662,13 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.postgreSqlHost)) {
+    if (entityStorageConnectorTypes) {
         coreConfig.types.entityStorageConnector.push({
             type: EntityStorageConnectorType.PostgreSql,
             options: {
                 config: {
-                    host: envVars.postgreSqlHost,
-                    port: envVars.postgreSqlPort,
+                    host: envVars.postgreSqlHost ?? "",
+                    port: Coerce.integer(envVars.postgreSqlPort),
                     user: envVars.postgreSqlUser ?? "",
                     password: envVars.postgreSqlPassword ?? "",
                     database: envVars.postgreSqlDatabase ?? ""
@@ -692,11 +677,12 @@ function configureEntityStorage(coreConfig, envVars) {
             }
         });
     }
-    const defaultStorageConnector = envVars.entityStorageConnectorType;
-    if (Is.stringValue(defaultStorageConnector)) {
+    if (Is.arrayValue(entityStorageConnectorTypes)) {
+        const defaultStorageConnectorType = envVars.entityStorageConnectorDefault ?? entityStorageConnectorTypes[0];
         for (const config of coreConfig.types.entityStorageConnector) {
-            if (config.type === defaultStorageConnector) {
+            if (config.type === defaultStorageConnectorType) {
                 config.isDefault = true;
+                break;
             }
         }
     }
@@ -708,14 +694,13 @@ function configureEntityStorage(coreConfig, envVars) {
  */
 function configureBlobStorage(coreConfig, envVars) {
     coreConfig.types.blobStorageConnector ??= [];
-    if ((Coerce.boolean(envVars.blobMemoryEnable) ?? false) ||
-        envVars.blobStorageConnectorType === BlobStorageConnectorType.Memory) {
+    const blobStorageConnectorTypes = envVars.blobStorageConnectorType?.split(",") ?? [];
+    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.Memory)) {
         coreConfig.types.blobStorageConnector.push({
             type: BlobStorageConnectorType.Memory
         });
     }
-    if ((Coerce.boolean(envVars.blobFileEnable) ?? false) ||
-        envVars.blobStorageConnectorType === BlobStorageConnectorType.File) {
+    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.File)) {
         coreConfig.types.blobStorageConnector.push({
             type: BlobStorageConnectorType.File,
             options: {
@@ -728,18 +713,18 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.ipfsApiUrl)) {
+    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.Ipfs)) {
         coreConfig.types.blobStorageConnector.push({
             type: BlobStorageConnectorType.Ipfs,
             options: {
                 config: {
-                    apiUrl: envVars.ipfsApiUrl,
+                    apiUrl: envVars.ipfsApiUrl ?? "",
                     bearerToken: envVars.ipfsBearerToken
                 }
             }
         });
     }
-    if (Is.stringValue(envVars.awsS3AccessKeyId)) {
+    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.AwsS3)) {
         coreConfig.types.blobStorageConnector.push({
             type: BlobStorageConnectorType.AwsS3,
             options: {
@@ -754,7 +739,7 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.azureStorageAccountKey)) {
+    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.AzureStorage)) {
         coreConfig.types.blobStorageConnector.push({
             type: BlobStorageConnectorType.AzureStorage,
             options: {
@@ -768,7 +753,7 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    if (Is.stringValue(envVars.gcpStorageCredentials)) {
+    if (blobStorageConnectorTypes.includes(BlobStorageConnectorType.GcpStorage)) {
         coreConfig.types.blobStorageConnector.push({
             type: BlobStorageConnectorType.GcpStorage,
             options: {
@@ -782,11 +767,12 @@ function configureBlobStorage(coreConfig, envVars) {
             }
         });
     }
-    const defaultStorageConnectorType = envVars.blobStorageConnectorType;
-    if (Is.stringValue(defaultStorageConnectorType)) {
+    if (Is.arrayValue(blobStorageConnectorTypes)) {
+        const defaultStorageConnectorType = envVars.blobStorageConnectorDefault ?? blobStorageConnectorTypes[0];
         for (const config of coreConfig.types.blobStorageConnector) {
             if (config.type === defaultStorageConnectorType) {
                 config.isDefault = true;
+                break;
             }
         }
     }
@@ -1526,8 +1512,10 @@ function buildEngineServerConfiguration(envVars, coreEngineConfig, serverInfo, o
  */
 async function start(nodeOptions, engineServerConfig, envVars) {
     envVars.storageFileRoot ??= "";
-    if ((envVars.entityStorageConnectorType === EntityStorageConnectorType.File ||
-        envVars.blobStorageConnectorType === BlobStorageConnectorType.File ||
+    const entityStorageConnectorType = envVars.entityStorageConnectorType?.split(",") ?? [];
+    const blobStorageConnectorType = envVars.blobStorageConnectorType?.split(",") ?? [];
+    if ((entityStorageConnectorType.includes(EntityStorageConnectorType.File) ||
+        blobStorageConnectorType.includes(BlobStorageConnectorType.File) ||
         Is.empty(nodeOptions?.stateStorage)) &&
         !Is.stringValue(envVars.storageFileRoot)) {
         throw new GeneralError("node", "storageFileRootNotSet", {
@@ -1578,7 +1566,7 @@ async function run(nodeOptions) {
         nodeOptions ??= {};
         const serverInfo = {
             name: nodeOptions?.serverName ?? "TWIN Node Server",
-            version: nodeOptions?.serverVersion ?? "0.0.1-next.11" // x-release-please-version
+            version: nodeOptions?.serverVersion ?? "0.0.2-next.2" // x-release-please-version
         };
         console.log(`\u001B[4m🌩️  ${serverInfo.name} v${serverInfo.version}\u001B[24m\n`);
         if (!Is.stringValue(nodeOptions?.executionDirectory)) {
@@ -1688,4 +1676,4 @@ async function buildConfiguration(processEnv, options, serverInfo) {
     return { engineServerConfig, nodeEnvVars: envVars };
 }
 
-export { NodeFeatures, bootstrap, bootstrapAttestationMethod, bootstrapAuth, bootstrapBlobEncryption, bootstrapImmutableProofMethod, bootstrapNodeIdentity, bootstrapNodeUser, buildConfiguration, buildEngineConfiguration, fileExists, getExecutionDirectory, getFeatures, initialiseLocales, loadJsonFile, run, start };
+export { NodeFeatures, bootstrap, bootstrapAttestationMethod, bootstrapAuth, bootstrapBlobEncryption, bootstrapImmutableProofMethod, bootstrapNodeIdentity, bootstrapNodeUser, buildConfiguration, buildEngineConfiguration, buildEngineServerConfiguration, fileExists, getExecutionDirectory, getFeatures, initialiseLocales, loadJsonFile, run, start };

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./bootstrap";
 export * from "./builders/engineEnvBuilder";
+export * from "./builders/engineServerEnvBuilder";
 export * from "./models/IEngineEnvironmentVariables";
 export * from "./models/IEngineServerEnvironmentVariables";
 export * from "./models/INodeEnvironmentVariables";

package/dist/types/models/IEngineEnvironmentVariables.d.ts

@@ -15,21 +15,22 @@ export interface IEngineEnvironmentVariables {
      */
     stateFilename?: string;
     /**
-     * The type of the default entity storage: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql.
+     * The type of the entity storage to create, comma separate for more than one connector.
+     * values: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql
      */
     entityStorageConnectorType?: string;
     /**
-     * A prefix for all the table in entity-storage, can be empty.
+     * The default entity storage connector to use, defaults to the first one in the list.
      */
-    entityStorageTablePrefix?: string;
+    entityStorageConnectorDefault?: string;
     /**
-     * Enable the file entity storage connector.
+     * Entity storage connector for decentralized storage
      */
-    entityFileEnable?: string;
+    entityStorageConnectorDecentralised?: string;
     /**
-     * Enable the memory entity storage connector.
+     * A prefix for all the table in entity-storage, can be empty.
      */
-    entityMemoryEnable?: string;
+    entityStorageTablePrefix?: string;
     /**
      * AWS Dynamo DB access key id.
      */
@@ -94,6 +95,10 @@ export interface IEngineEnvironmentVariables {
      * ScyllaDB local data center.
      */
     scylladbLocalDataCenter?: string;
+    /**
+     * ScyllaDB port.
+     */
+    scylladbPort?: string;
     /**
      * MySQL host.
      */
@@ -163,9 +168,18 @@ export interface IEngineEnvironmentVariables {
      */
     ipfsApiUrl?: string;
     /**
-     * The type of the default blob storage: memory, file, ipfs, aws-s3, azure-storage, gcp-storage.
+     * The type of the entity storage to create, comma separate for more than one connector.
+     * values: memory, file, ipfs, aws-s3, azure-storage, gcp-storage.
      */
     blobStorageConnectorType?: string;
+    /**
+     * The default blob storage connector to use, defaults to the first one in the list.
+     */
+    blobStorageConnectorDefault?: string;
+    /**
+     * Blog storage connector for decentralized storage
+     */
+    blobStorageConnectorDecentralised?: string;
     /**
      * Enable encryption for the blob storage.
      */
@@ -178,14 +192,6 @@ export interface IEngineEnvironmentVariables {
      * A prefix for all the blobs in blob-storage, can be empty.
      */
     blobStoragePrefix?: string;
-    /**
-     * Enable the file blob storage connector.
-     */
-    blobFileEnable?: string;
-    /**
-     * Enable the memory blob storage connector.
-     */
-    blobMemoryEnable?: string;
     /**
      * AWS S3 access key id.
      */

package/docs/changelog.md

@@ -1,5 +1,38 @@
 # @twin.org/node-core - Changelog
 
+## [0.0.2-next.2](https://github.com/twinfoundation/node/compare/node-core-v0.0.2-next.1...node-core-v0.0.2-next.2) (2025-07-17)
+
+
+### Features
+
+* support multiple entity and blob storage connectors ([a489f79](https://github.com/twinfoundation/node/commit/a489f7907544aef5708d5111e9f72985e1377bae))
+
+## [0.0.2-next.1](https://github.com/twinfoundation/node/compare/node-core-v0.0.2-next.0...node-core-v0.0.2-next.1) (2025-07-15)
+
+
+### Features
+
+* add auth admin component ([1661e57](https://github.com/twinfoundation/node/commit/1661e57a699d5cf9ebde333e3cbc3aaea89d7c9c))
+* add extend engine and server methods ([ec09c7e](https://github.com/twinfoundation/node/commit/ec09c7eb882d9f5797f2fd372e96cad1a3716f59))
+* add extend engine and server methods ([0136a6f](https://github.com/twinfoundation/node/commit/0136a6f3f4e1a82b1427ee9618b8a17c79bc7fda))
+* add missing export ([e8eb621](https://github.com/twinfoundation/node/commit/e8eb6213937a202520b164a9970a891004122b61))
+* additional run options ([c35e5bb](https://github.com/twinfoundation/node/commit/c35e5bbb8a80fe6a36628d41f64585b3723d9ad7))
+* additional startup logging ([0740293](https://github.com/twinfoundation/node/commit/0740293b366032f2907046603abf587c9c324aff))
+* improve default options and spec ([b538721](https://github.com/twinfoundation/node/commit/b538721902e7f65021d2715148ba59409ccce035))
+* improve error reporting ([fcd39a1](https://github.com/twinfoundation/node/commit/fcd39a18da2a6ce33965a99ca5f2f36f4aba712f))
+* initial commit ([522f1e5](https://github.com/twinfoundation/node/commit/522f1e515348f9b1dd1eeb3170b1249e2b0b5371))
+* migrate env config from engine to node ([5da29b8](https://github.com/twinfoundation/node/commit/5da29b8d714495308320d237a68e84355bba2b47))
+* node app use JavaScript ([14fe08c](https://github.com/twinfoundation/node/commit/14fe08cb760dd885a5dac9056a4d5dbc3d61df64))
+* update dependencies ([9d25f16](https://github.com/twinfoundation/node/commit/9d25f16f1d554cd38f3bec28fdf7f8fff892ceaf))
+
+
+### Bug Fixes
+
+* adding a condition to verify if the password exists when bootstrapping ([6030a42](https://github.com/twinfoundation/node/commit/6030a42bdaf581678d96932fd0b809396bf7b8b0))
+* adding a condition to verify if the password exists when bootstrapping ([c66f396](https://github.com/twinfoundation/node/commit/c66f396717394161a7647d1f08b3d87729d96e96))
+* broken docs ([61479fd](https://github.com/twinfoundation/node/commit/61479fd618f766d22c5aafec5277e1a89e22b453))
+* pr comments [#1](https://github.com/twinfoundation/node/issues/1) ([66e795b](https://github.com/twinfoundation/node/commit/66e795b16c372ab131ec1de30085aee90e4dbbd0))
+
 ## 0.0.1 (2025-07-11)
 
 

package/docs/reference/functions/buildEngineServerConfiguration.md

@@ -0,0 +1,37 @@
+# Function: buildEngineServerConfiguration()
+
+> **buildEngineServerConfiguration**(`envVars`, `coreEngineConfig`, `serverInfo`, `openApiSpecPath?`): `IEngineServerConfig`
+
+Handles the configuration of the server.
+
+## Parameters
+
+### envVars
+
+[`IEngineServerEnvironmentVariables`](../interfaces/IEngineServerEnvironmentVariables.md)
+
+The environment variables for the engine server.
+
+### coreEngineConfig
+
+`IEngineCoreConfig`
+
+The core engine config.
+
+### serverInfo
+
+`IServerInfo`
+
+The server information.
+
+### openApiSpecPath?
+
+`string`
+
+The path to the open api spec.
+
+## Returns
+
+`IEngineServerConfig`
+
+The the config for the core and the server.

package/docs/reference/index.md

@@ -25,6 +25,7 @@
 - [bootstrapBlobEncryption](functions/bootstrapBlobEncryption.md)
 - [bootstrapAuth](functions/bootstrapAuth.md)
 - [buildEngineConfiguration](functions/buildEngineConfiguration.md)
+- [buildEngineServerConfiguration](functions/buildEngineServerConfiguration.md)
 - [run](functions/run.md)
 - [buildConfiguration](functions/buildConfiguration.md)
 - [start](functions/start.md)

package/docs/reference/interfaces/IEngineEnvironmentVariables.md

@@ -36,31 +36,32 @@ The name of the state file.
 
 > `optional` **entityStorageConnectorType**: `string`
 
-The type of the default entity storage: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql.
+The type of the entity storage to create, comma separate for more than one connector.
+values: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql
 
 ***
 
-### entityStorageTablePrefix?
+### entityStorageConnectorDefault?
 
-> `optional` **entityStorageTablePrefix**: `string`
+> `optional` **entityStorageConnectorDefault**: `string`
 
-A prefix for all the table in entity-storage, can be empty.
+The default entity storage connector to use, defaults to the first one in the list.
 
 ***
 
-### entityFileEnable?
+### entityStorageConnectorDecentralised?
 
-> `optional` **entityFileEnable**: `string`
+> `optional` **entityStorageConnectorDecentralised**: `string`
 
-Enable the file entity storage connector.
+Entity storage connector for decentralized storage
 
 ***
 
-### entityMemoryEnable?
+### entityStorageTablePrefix?
 
-> `optional` **entityMemoryEnable**: `string`
+> `optional` **entityStorageTablePrefix**: `string`
 
-Enable the memory entity storage connector.
+A prefix for all the table in entity-storage, can be empty.
 
 ***
 
@@ -192,6 +193,14 @@ ScyllaDB local data center.
 
 ***
 
+### scylladbPort?
+
+> `optional` **scylladbPort**: `string`
+
+ScyllaDB port.
+
+***
+
 ### mySqlHost?
 
 > `optional` **mySqlHost**: `string`
@@ -332,47 +341,48 @@ The url for accessing IPFS API.
 
 > `optional` **blobStorageConnectorType**: `string`
 
-The type of the default blob storage: memory, file, ipfs, aws-s3, azure-storage, gcp-storage.
+The type of the entity storage to create, comma separate for more than one connector.
+values: memory, file, ipfs, aws-s3, azure-storage, gcp-storage.
 
 ***
 
-### blobStorageEnableEncryption?
+### blobStorageConnectorDefault?
 
-> `optional` **blobStorageEnableEncryption**: `string`
+> `optional` **blobStorageConnectorDefault**: `string`
 
-Enable encryption for the blob storage.
+The default blob storage connector to use, defaults to the first one in the list.
 
 ***
 
-### blobStorageEncryptionKey?
+### blobStorageConnectorDecentralised?
 
-> `optional` **blobStorageEncryptionKey**: `string`
+> `optional` **blobStorageConnectorDecentralised**: `string`
 
-The encryption key for the blob storage.
+Blog storage connector for decentralized storage
 
 ***
 
-### blobStoragePrefix?
+### blobStorageEnableEncryption?
 
-> `optional` **blobStoragePrefix**: `string`
+> `optional` **blobStorageEnableEncryption**: `string`
 
-A prefix for all the blobs in blob-storage, can be empty.
+Enable encryption for the blob storage.
 
 ***
 
-### blobFileEnable?
+### blobStorageEncryptionKey?
 
-> `optional` **blobFileEnable**: `string`
+> `optional` **blobStorageEncryptionKey**: `string`
 
-Enable the file blob storage connector.
+The encryption key for the blob storage.
 
 ***
 
-### blobMemoryEnable?
+### blobStoragePrefix?
 
-> `optional` **blobMemoryEnable**: `string`
+> `optional` **blobStoragePrefix**: `string`
 
-Enable the memory blob storage connector.
+A prefix for all the blobs in blob-storage, can be empty.
 
 ***
 

package/docs/reference/interfaces/INodeEnvironmentVariables.md

@@ -48,7 +48,8 @@ The name of the state file.
 
 > `optional` **entityStorageConnectorType**: `string`
 
-The type of the default entity storage: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql.
+The type of the entity storage to create, comma separate for more than one connector.
+values: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql
 
 #### Inherited from
 
@@ -56,39 +57,39 @@ The type of the default entity storage: file, memory, aws-dynamodb, azure-cosmos
 
 ***
 
-### entityStorageTablePrefix?
+### entityStorageConnectorDefault?
 
-> `optional` **entityStorageTablePrefix**: `string`
+> `optional` **entityStorageConnectorDefault**: `string`
 
-A prefix for all the table in entity-storage, can be empty.
+The default entity storage connector to use, defaults to the first one in the list.
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`entityStorageTablePrefix`](IEngineEnvironmentVariables.md#entitystoragetableprefix)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`entityStorageConnectorDefault`](IEngineEnvironmentVariables.md#entitystorageconnectordefault)
 
 ***
 
-### entityFileEnable?
+### entityStorageConnectorDecentralised?
 
-> `optional` **entityFileEnable**: `string`
+> `optional` **entityStorageConnectorDecentralised**: `string`
 
-Enable the file entity storage connector.
+Entity storage connector for decentralized storage
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`entityFileEnable`](IEngineEnvironmentVariables.md#entityfileenable)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`entityStorageConnectorDecentralised`](IEngineEnvironmentVariables.md#entitystorageconnectordecentralised)
 
 ***
 
-### entityMemoryEnable?
+### entityStorageTablePrefix?
 
-> `optional` **entityMemoryEnable**: `string`
+> `optional` **entityStorageTablePrefix**: `string`
 
-Enable the memory entity storage connector.
+A prefix for all the table in entity-storage, can be empty.
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`entityMemoryEnable`](IEngineEnvironmentVariables.md#entitymemoryenable)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`entityStorageTablePrefix`](IEngineEnvironmentVariables.md#entitystoragetableprefix)
 
 ***
 
@@ -284,6 +285,18 @@ ScyllaDB local data center.
 
 ***
 
+### scylladbPort?
+
+> `optional` **scylladbPort**: `string`
+
+ScyllaDB port.
+
+#### Inherited from
+
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`scylladbPort`](IEngineEnvironmentVariables.md#scylladbport)
+
+***
+
 ### mySqlHost?
 
 > `optional` **mySqlHost**: `string`
@@ -492,7 +505,8 @@ The url for accessing IPFS API.
 
 > `optional` **blobStorageConnectorType**: `string`
 
-The type of the default blob storage: memory, file, ipfs, aws-s3, azure-storage, gcp-storage.
+The type of the entity storage to create, comma separate for more than one connector.
+values: memory, file, ipfs, aws-s3, azure-storage, gcp-storage.
 
 #### Inherited from
 
@@ -500,63 +514,63 @@ The type of the default blob storage: memory, file, ipfs, aws-s3, azure-storage,
 
 ***
 
-### blobStorageEnableEncryption?
+### blobStorageConnectorDefault?
 
-> `optional` **blobStorageEnableEncryption**: `string`
+> `optional` **blobStorageConnectorDefault**: `string`
 
-Enable encryption for the blob storage.
+The default blob storage connector to use, defaults to the first one in the list.
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStorageEnableEncryption`](IEngineEnvironmentVariables.md#blobstorageenableencryption)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStorageConnectorDefault`](IEngineEnvironmentVariables.md#blobstorageconnectordefault)
 
 ***
 
-### blobStorageEncryptionKey?
+### blobStorageConnectorDecentralised?
 
-> `optional` **blobStorageEncryptionKey**: `string`
+> `optional` **blobStorageConnectorDecentralised**: `string`
 
-The encryption key for the blob storage.
+Blog storage connector for decentralized storage
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStorageEncryptionKey`](IEngineEnvironmentVariables.md#blobstorageencryptionkey)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStorageConnectorDecentralised`](IEngineEnvironmentVariables.md#blobstorageconnectordecentralised)
 
 ***
 
-### blobStoragePrefix?
+### blobStorageEnableEncryption?
 
-> `optional` **blobStoragePrefix**: `string`
+> `optional` **blobStorageEnableEncryption**: `string`
 
-A prefix for all the blobs in blob-storage, can be empty.
+Enable encryption for the blob storage.
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStoragePrefix`](IEngineEnvironmentVariables.md#blobstorageprefix)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStorageEnableEncryption`](IEngineEnvironmentVariables.md#blobstorageenableencryption)
 
 ***
 
-### blobFileEnable?
+### blobStorageEncryptionKey?
 
-> `optional` **blobFileEnable**: `string`
+> `optional` **blobStorageEncryptionKey**: `string`
 
-Enable the file blob storage connector.
+The encryption key for the blob storage.
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobFileEnable`](IEngineEnvironmentVariables.md#blobfileenable)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStorageEncryptionKey`](IEngineEnvironmentVariables.md#blobstorageencryptionkey)
 
 ***
 
-### blobMemoryEnable?
+### blobStoragePrefix?
 
-> `optional` **blobMemoryEnable**: `string`
+> `optional` **blobStoragePrefix**: `string`
 
-Enable the memory blob storage connector.
+A prefix for all the blobs in blob-storage, can be empty.
 
 #### Inherited from
 
-[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobMemoryEnable`](IEngineEnvironmentVariables.md#blobmemoryenable)
+[`IEngineEnvironmentVariables`](IEngineEnvironmentVariables.md).[`blobStoragePrefix`](IEngineEnvironmentVariables.md#blobstorageprefix)
 
 ***
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.0.1",
+	"version": "0.0.2-next.2",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -14,21 +14,21 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/api-auth-entity-storage-service": "^0.0.2-next.1",
-		"@twin.org/core": "^0.0.1",
-		"@twin.org/crypto": "^0.0.1",
-		"@twin.org/engine": "^0.0.2-next.1",
-		"@twin.org/engine-core": "^0.0.2-next.1",
-		"@twin.org/engine-models": "^0.0.2-next.1",
-		"@twin.org/engine-server": "^0.0.2-next.1",
-		"@twin.org/engine-server-types": "^0.0.2-next.1",
-		"@twin.org/engine-types": "^0.0.2-next.1",
-		"@twin.org/entity": "^0.0.1",
-		"@twin.org/entity-storage-models": "^0.0.1",
-		"@twin.org/identity-models": "^0.0.1",
-		"@twin.org/vault-models": "^0.0.1",
-		"@twin.org/wallet-models": "^0.0.1",
-		"dotenv": "16.5.0",
+		"@twin.org/api-auth-entity-storage-service": "next",
+		"@twin.org/core": "next",
+		"@twin.org/crypto": "next",
+		"@twin.org/engine": "next",
+		"@twin.org/engine-core": "next",
+		"@twin.org/engine-models": "next",
+		"@twin.org/engine-server": "next",
+		"@twin.org/engine-server-types": "next",
+		"@twin.org/engine-types": "next",
+		"@twin.org/entity": "next",
+		"@twin.org/entity-storage-models": "next",
+		"@twin.org/identity-models": "next",
+		"@twin.org/vault-models": "next",
+		"@twin.org/wallet-models": "next",
+		"dotenv": "17.2.0",
 		"schema-dts": "1.1.5"
 	},
 	"main": "./dist/cjs/index.cjs",