@digitaldefiance/express-suite-starter 2.3.5 → 2.3.6

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/load-env.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+
+# Check if we're in a /workspaces or /workspace path
+if [[ "${PWD}" =~ ^/workspaces?/ ]]; then
+  WORKSPACE=$(echo "${PWD}" | grep -oP '^/workspaces?/[^/]+')
+elif [ "$(basename "${PWD}")" = ".devcontainer" ]; then
+  WORKSPACE=$(realpath "${PWD}/..")
+else
+  WORKSPACE=$(realpath "${SCRIPT_DIR}/..")
+fi
+
+DEVCONTAINER_DIR="${WORKSPACE}/.devcontainer"
+
+if [ -f "${DEVCONTAINER_DIR}/.env" ]; then
+  echo "Loading environment variables from ${DEVCONTAINER_DIR}/.env"
+  set -a
+  source "${DEVCONTAINER_DIR}/.env"
+  set +a
+fi

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/mongodb_entrypoint.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+set -e
+
+echo "Hostname: $(hostname)"
+
+# Environment Variables with Defaults
+MONGO_LOG=${MONGO_LOG:-"/var/log/mongodb/mongod.log"}
+MONGO_INITDB_ROOT_USERNAME=${MONGO_INITDB_ROOT_USERNAME}
+MONGO_INITDB_ROOT_PASSWORD=${MONGO_INITDB_ROOT_PASSWORD}
+MONGO_REPLICA_SET_NAME=${MONGO_REPLICA_SET_NAME:-"rs0"}
+MONGO_BIND_IP=${MONGO_BIND_IP:-"0.0.0.0"}
+MONGO_PORT=${MONGO_PORT:-27017}
+MONGO_KEYFILE=${MONGO_KEYFILE:-"/tmp/replica.key"}
+MONGO_DB_PATH=${MONGO_DB_PATH:-"/data/db"}
+MAX_ATTEMPTS=30
+RETRY_INTERVAL=${RETRY_INTERVAL:-30}
+SETUP_COMPLETE_FILE="/data/db/.setup_complete"
+
+start_mongo_noauth() {
+    echo "Starting MongoDB without authentication..."
+    mongod --replSet "$MONGO_REPLICA_SET_NAME" --bind_ip_all --dbpath "$MONGO_DB_PATH" --logpath "$MONGO_LOG" \
+        --wiredTigerCacheSizeGB 0.5 \
+        --fork
+}
+
+wait_for_mongo() {
+    echo "Waiting for MongoDB to be ready..."
+    for i in $(seq 1 $MAX_ATTEMPTS); do
+        if mongosh --quiet --eval "db.runCommand({ ping: 1 })" &>/dev/null; then
+            echo "MongoDB is ready."
+            return 0
+        fi
+        echo "Attempt $i: MongoDB not ready yet, retrying in $RETRY_INTERVAL seconds..."
+        sleep $RETRY_INTERVAL
+    done
+    echo "Failed to connect to MongoDB after $MAX_ATTEMPTS attempts."
+    return 1
+}
+
+initialize_replica_set() {
+    echo "Initializing replica set with localhost..."
+    mongosh --quiet --eval "
+        rs.initiate({
+            _id: '$MONGO_REPLICA_SET_NAME',
+            members: [{ _id: 0, host: 'localhost:$MONGO_PORT' }]
+        })
+    "
+}
+
+wait_for_primary() {
+    echo "Waiting for replica set to become PRIMARY..."
+    for i in $(seq 1 $MAX_ATTEMPTS); do
+        if [ "$1" = "auth" ]; then
+            status=$(mongosh admin --quiet --eval "db.auth('$MONGO_INITDB_ROOT_USERNAME', '$MONGO_INITDB_ROOT_PASSWORD'); rs.status().myState")
+        else
+            status=$(mongosh --quiet --eval "rs.status().myState")
+        fi
+        if [ "$status" = "1" ]; then
+            echo "Replica set is now PRIMARY."
+            return 0
+        fi
+        echo "Attempt $i: Replica set is not PRIMARY yet, retrying in $RETRY_INTERVAL seconds..."
+        sleep $RETRY_INTERVAL
+    done
+    echo "Replica set did not become PRIMARY within the expected time."
+    return 1
+}
+
+create_root_user() {
+    echo "Creating root user..."
+    mongosh admin --quiet --eval "
+        db.createUser({
+            user: '$MONGO_INITDB_ROOT_USERNAME',
+            pwd: '$MONGO_INITDB_ROOT_PASSWORD',
+            roles: [{ role: 'root', db: 'admin' }]
+        });
+    "
+}
+
+start_mongo_auth() {
+    echo "Starting MongoDB with authentication..."
+    mongod --auth --replSet "$MONGO_REPLICA_SET_NAME" --bind_ip_all --dbpath "$MONGO_DB_PATH" --logpath "$MONGO_LOG" --keyFile "$MONGO_KEYFILE" \
+        --wiredTigerCacheSizeGB 0.5 \
+        --fork
+}
+
+start_mongo_auth_foreground() {
+    echo "Starting MongoDB with authentication in the foreground..."
+    exec mongod --auth --replSet "$MONGO_REPLICA_SET_NAME" --bind_ip_all --dbpath "$MONGO_DB_PATH" --keyFile "$MONGO_KEYFILE" \
+        --wiredTigerCacheSizeGB 0.5
+}
+
+if [ -f "$SETUP_COMPLETE_FILE" ]; then
+    echo "Setup already completed. Starting MongoDB in foreground mode."
+    start_mongo_auth_foreground
+    exit 0
+fi
+
+# Main execution flow
+echo "Starting MongoDB setup..."
+
+start_mongo_noauth
+wait_for_mongo || exit 1
+
+echo "Initializing replica set..."
+initialize_replica_set
+wait_for_primary || exit 1
+
+echo "Creating root user..."
+create_root_user
+
+echo "Shutting down MongoDB to restart with authentication..."
+mongod --shutdown
+
+echo "Starting MongoDB with authentication..."
+start_mongo_auth
+wait_for_mongo || exit 1
+wait_for_primary "auth" || exit 1
+
+# Mark setup as complete
+touch "$SETUP_COMPLETE_FILE"
+
+echo "MongoDB setup completed successfully. Starting MongoDB in foreground mode."
+start_mongo_auth_foreground

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/mongodb_healthcheck.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+MAX_ATTEMPTS=30
+RETRY_INTERVAL=10
+
+# Wait for MongoDB to start
+for i in $(seq 1 $MAX_ATTEMPTS); do
+    if mongosh --quiet --eval 'db.runCommand({ ping: 1 })' >/dev/null 2>&1; then
+        echo "[HC] MongoDB is responsive."
+        break
+    fi
+    echo "[HC] Attempt $i/$MAX_ATTEMPTS: Waiting for MongoDB to start..."
+    sleep $RETRY_INTERVAL
+    if [ $i -eq $MAX_ATTEMPTS ]; then
+        echo "[HC] MongoDB failed to start after $MAX_ATTEMPTS attempts."
+        exit 1
+    fi
+done
+
+# Check if MongoDB replica set is ready
+for i in $(seq 1 $MAX_ATTEMPTS); do
+    rs_status=$(mongosh --quiet --eval 'rs.status().ok' --authenticationDatabase admin -u "$MONGO_INITDB_ROOT_USERNAME" -p "$MONGO_INITDB_ROOT_PASSWORD" || echo "0")
+    if [ "$rs_status" = "1" ]; then
+        echo "[HC] MongoDB replica set is ready."
+        exit 0
+    fi
+    echo "[HC] Attempt $i/$MAX_ATTEMPTS: Waiting for MongoDB replica set to be ready..."
+    sleep $RETRY_INTERVAL
+    if [ $i -eq $MAX_ATTEMPTS ]; then
+        echo "[HC] MongoDB replica set failed to initialize after $MAX_ATTEMPTS attempts."
+        exit 1
+    fi
+done
+
+echo "[HC] MongoDB healthcheck failed."
+exit 1

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/post-create.sh.hbs

@@ -0,0 +1,54 @@
+#!/bin/bash
+set -e
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+WORKSPACE=$(realpath "${SCRIPT_DIR}/..")
+
+echo "Post-create setup starting..."
+
+cd ${WORKSPACE} && source .devcontainer/load-env.sh
+
+# Basic git setup
+git config --global --add safe.directory ${WORKSPACE} 2>/dev/null || true
+
+cd ${WORKSPACE} && ./setup-nvm.sh
+cd ${WORKSPACE} && ./ensure-git-globals.sh
+cd ${WORKSPACE} && ./recover-yarn.sh
+
+cd ${WORKSPACE} && export COREPACK_ENABLE_DOWNLOAD_PROMPT=0 && yes | corepack enable
+
+# Setup Yarn Berry
+echo "Setting up Yarn Berry..."
+cd ${WORKSPACE} && corepack prepare yarn@${DEFAULT_YARN_VERSION} --activate && corepack yarn set version ${DEFAULT_YARN_VERSION} || echo "Yarn Berry setup failed"
+
+# Install dependencies
+echo "Installing dependencies..."
+cd ${WORKSPACE} && corepack yarn config set nodeLinker node-modules
+
+MAX_ATTEMPTS=5;
+WAIT_TIME=2;
+REGISTRY_URL=http://host.docker.internal:4873/;
+ATTEMPTS=0;
+echo 'Waiting for Verdaccio registry at $REGISTRY_URL (Max 10s total, 4s timeout per attempt)...';
+while [ $ATTEMPTS -lt $MAX_ATTEMPTS ]; do
+  # Increased timeouts for cross-host networking stability: 2s connect, 4s total time.
+  if curl -sS -o /dev/null --fail --connect-timeout 2 --max-time 4 $REGISTRY_URL; then
+    echo 'Verdaccio detected. Configuring NPM and YARN.';
+      npm config set registry $REGISTRY_URL --location=project;
+      yarn config set npmRegistryServer $REGISTRY_URL;
+      VERDACCIO=1;
+      break;
+  fi;
+  sleep $WAIT_TIME;
+  ATTEMPTS=$((ATTEMPTS + 1));
+done;
+[ -z "$VERDACCIO" ] && echo 'Verdaccio not detected after 5 attempts. Using default public registry.';
+
+cd ${WORKSPACE} && ./npm-install-globals.sh
+cd ${WORKSPACE} && ./do-yarn.sh || echo "Dependency installation failed"
+
+cd ${WORKSPACE} && /usr/local/bin/mkcert localhost 127.0.0.1 ::1 {{hostname}}
+
+echo ""
+cd ${WORKSPACE} && yarn playwright install --with-deps || echo "Playwright installation failed"
+
+echo "Post-create setup complete"

package/scaffolding/devcontainer-simple/.devcontainer/.env.example

@@ -0,0 +1,4 @@
+DEFAULT_YARN_VERSION=4.11.0
+DEFAULT_NVM_VERSION=22
+GIT_EMAIL=your@email.com
+GIT_NAME="Your Name"

package/scaffolding/devcontainer-simple/.devcontainer/devcontainer.json.mustache

@@ -0,0 +1,60 @@
+{
+  "name": "{{workspaceName}} - Node.js",
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:20",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+          "github.vscode-github-actions",
+          "ms-azuretools.vscode-docker",
+          "esbenp.prettier-vscode",
+          "ms-vscode-remote.remote-containers",
+          "firsttris.vscode-jest-runner",
+          "ms-playwright.playwright",
+          "nrwl.angular-console",
+          "GitHub.copilot",
+          "GitHub.copilot-chat",
+          "bruno-api-client.bruno"
+      ]
+    }
+  },
+  "hostRequirements": {
+    "memory": "16gb",
+    "cpus": 4
+  },
+  "runArgs": [
+    "--memory=16g",
+    "--memory-swap=16g",
+    "--cpus=4",
+    "--dns=1.1.1.1",
+    "--dns=8.8.8.8",
+    "--add-host=host.docker.internal:host-gateway",
+    "-p",
+    "3000:3000",
+    "-p",
+    "3443:3443",
+    "-p",
+    "4200:4200",
+  ],
+  "mounts": [
+    "source=${localWorkspaceFolder}/.devcontainer/.env,target=/workspaces/${localWorkspaceFolderBasename}/.env,type=bind,consistency=cached"
+  ],
+  "forwardPorts": [3000, 3443, 4200],
+  "portsAttributes": {
+    "3443": {
+      "label": "HTTPS Server",
+      "protocol": "https",
+      "onAutoForward": "notify"
+    },
+    "3000": {
+      "label": "HTTP Server",
+      "protocol": "http",
+      "onAutoForward": "notify"
+    },
+    "4200": {
+      "label": "React Dev Server",
+      "protocol": "http",
+      "onAutoForward": "notify"
+    }
+  },
+  "postCreateCommand": "set -a && [ -f .env ] && . ./.env && set +a && .devcontainer/post-create.sh"
+}

package/scaffolding/devcontainer-simple/.devcontainer/post-create.sh.hbs

@@ -0,0 +1,72 @@
+#!/bin/bash
+set -e
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+WORKSPACE=$(realpath "${SCRIPT_DIR}/..")
+
+echo "Post-create setup starting..."
+
+# Basic git setup
+git config --global --add safe.directory ${WORKSPACE} 2>/dev/null || true
+
+cd ${WORKSPACE} && ./setup-nvm.sh
+cd ${WORKSPACE} && ./ensure-git-globals.sh
+cd ${WORKSPACE} && ./recover-yarn.sh
+
+cd ${WORKSPACE} && export COREPACK_ENABLE_DOWNLOAD_PROMPT=0 && yes | corepack enable
+
+# Setup Yarn Berry
+echo "Setting up Yarn Berry..."
+cd ${WORKSPACE} && corepack prepare yarn@${DEFAULT_YARN_VERSION} --activate && corepack yarn set version ${DEFAULT_YARN_VERSION} || echo "Yarn Berry setup failed"
+
+# Install dependencies
+echo "Installing dependencies..."
+cd ${WORKSPACE} && corepack yarn config set nodeLinker node-modules
+
+MAX_ATTEMPTS=5;
+WAIT_TIME=2;
+REGISTRY_URL=http://host.docker.internal:4873/;
+ATTEMPTS=0;
+echo 'Waiting for Verdaccio registry at $REGISTRY_URL (Max 10s total, 4s timeout per attempt)...';
+while [ $ATTEMPTS -lt $MAX_ATTEMPTS ]; do
+  # Increased timeouts for cross-host networking stability: 2s connect, 4s total time.
+  if curl -sS -o /dev/null --fail --connect-timeout 2 --max-time 4 $REGISTRY_URL; then
+    echo 'Verdaccio detected. Configuring NPM and YARN.';
+      npm config set registry $REGISTRY_URL --location=project;
+      yarn config set npmRegistryServer $REGISTRY_URL;
+      VERDACCIO=1;
+      break;
+  fi;
+  sleep $WAIT_TIME;
+  ATTEMPTS=$((ATTEMPTS + 1));
+done;
+[ -z "$VERDACCIO" ] && echo 'Verdaccio not detected after 5 attempts. Using default public registry.';
+
+cd ${WORKSPACE} && ./npm-install-globals.sh
+cd ${WORKSPACE} && ./do-yarn.sh || echo "Dependency installation failed"
+
+# Install mkcert if not already present
+if ! command -v mkcert &> /dev/null; then
+  echo "Installing mkcert..."
+  sudo apt-get update -y && sudo apt-get install golang -y
+  
+  # Clean up any existing mkcert directory from failed attempts
+  [ -d "${WORKSPACE}/mkcert" ] && rm -rf "${WORKSPACE}/mkcert"
+  
+  cd ${WORKSPACE} && \
+    git clone https://github.com/FiloSottile/mkcert && \
+    cd mkcert && \
+    go build -ldflags "-X main.Version=$(git describe --tags)" && \
+    sudo cp mkcert /usr/local/bin/ && \
+    cd .. && \
+    rm -rf mkcert
+  
+  /usr/local/bin/mkcert -install
+else
+  echo "mkcert already installed"
+fi
+cd ${WORKSPACE} && /usr/local/bin/mkcert localhost 127.0.0.1 ::1 {{hostname}}
+
+echo ""
+cd ${WORKSPACE} && yarn playwright install --with-deps || echo "Playwright installation failed"
+
+echo "Post-create setup complete"

package/scaffolding/inituserdb/.env.example.mustache

@@ -0,0 +1,9 @@
+MONGO_URI=mongodb://admin:{{password}}@db:27017/{{workspaceName}}?authSource=admin&directConnection=true
+JWT_SECRET={{jwtSecret}}
+API_DIST_DIR=/workspaces/{{workspaceName}}/dist/{{prefix}}-api
+REACT_DIST_DIR=/workspaces/{{workspaceName}}/dist/{{prefix}}-react
+DEBUG=true
+DETAILED_DEBUG=true
+MNEMONIC_ENCRYPTION_KEY={{mnemonicEncryptionKey}}
+MNEMONIC_HMAC_SECRET={{mnemonicHmacSecret}}
+MONGO_USE_TRANSACTIONS=false

package/scaffolding/inituserdb/src/main.ts.mustache

@@ -0,0 +1,178 @@
+import {
+  BaseApplication,
+  DatabaseInitializationService,
+  Environment,
+  IServerInitResult,
+  getSchemaMap,
+} from '@digitaldefiance/node-express-suite';
+
+// Simple debugLog implementation
+function debugLog(debug: boolean, type: 'log' | 'warn' | 'error', ...args: any[]): void {
+  if (debug) {
+    console[type](...args);
+  }
+}
+import { Constants as AppConstants } from '{{namespace}}/api-lib';
+import { GlobalActiveContext, IActiveContext } from '@digitaldefiance/i18n-lib';
+import { IECIESConfig } from '@digitaldefiance/ecies-lib';
+import { ECIESService } from '@digitaldefiance/node-ecies-lib';
+import {
+  CoreLanguageCode,
+} from '@digitaldefiance/i18n-lib';
+import { getSuiteCoreI18nEngine, getSuiteCoreTranslation, IFailableResult, SuiteCoreStringKey } from '@digitaldefiance/suite-core-lib';
+import { randomBytes } from 'crypto';
+import { join } from 'path';
+
+async function main() {
+  const context = GlobalActiveContext.getInstance<CoreLanguageCode, IActiveContext<CoreLanguageCode>>();
+  context.languageContextSpace = 'admin';
+
+  const config: IECIESConfig = {
+    curveName: AppConstants.ECIES.CURVE_NAME,
+    primaryKeyDerivationPath: AppConstants.ECIES.PRIMARY_KEY_DERIVATION_PATH,
+    mnemonicStrength: AppConstants.ECIES.MNEMONIC_STRENGTH,
+    symmetricAlgorithm: AppConstants.ECIES.SYMMETRIC_ALGORITHM_CONFIGURATION,
+    symmetricKeyBits: AppConstants.ECIES.SYMMETRIC.KEY_BITS,
+    symmetricKeyMode: AppConstants.ECIES.SYMMETRIC.MODE,
+  };
+  const eciesService = new ECIESService(config);
+  if (process.argv.includes('--gen-system-user-mnemonic')) {
+    const mnemonic = eciesService.generateNewMnemonic();
+    process.env.ADMIN_MNEMONIC = mnemonic.value;
+    console.log(
+      `ADMIN_MNEMONIC="${mnemonic.value}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+  if (process.argv.includes('--gen-member-user-mnemonic')) {
+    const mnemonic = eciesService.generateNewMnemonic();
+    process.env.MEMBER_MNEMONIC = mnemonic.value;
+    console.log(
+      `MEMBER_MNEMONIC="${mnemonic.value}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+  if (process.argv.includes('--gen-mnemonic-hmac-secret')) {
+    const mnemonicHmacSecret = randomBytes(32).toString('hex');
+    process.env.MNEMONIC_HMAC_SECRET = mnemonicHmacSecret;
+    console.log(
+      `MNEMONIC_HMAC_SECRET="${mnemonicHmacSecret}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+  if (process.argv.includes('--gen-mnemonic-encryption-key')) {
+    const mnemonicEncryptionKey = randomBytes(32).toString('hex');
+    process.env.MNEMONIC_ENCRYPTION_KEY = mnemonicEncryptionKey;
+    console.log(
+      `MNEMONIC_ENCRYPTION_KEY="${mnemonicEncryptionKey}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+
+  const envDir = join(
+    BaseApplication.distDir,
+    '{{prefix}}-inituserdb',
+    '.env',
+  );
+  const env: Environment = new Environment(envDir, true);
+  const app = new BaseApplication(env, getSchemaMap, DatabaseInitializationService.initUserDb, DatabaseInitializationService.serverInitResultHash, AppConstants);
+  context.languageContextSpace = 'admin';
+  const shouldDropDatabase = process.argv.includes('--drop');
+  debugLog(
+    app.environment.detailedDebug,
+    'log',
+    getSuiteCoreTranslation(SuiteCoreStringKey.Admin_TransactionsEnabledDisabledTemplate, {
+      STATE: getSuiteCoreTranslation(
+        app.environment.mongo.useTransactions
+          ? SuiteCoreStringKey.Common_Enabled
+          : SuiteCoreStringKey.Common_Disabled,
+      ),
+    }),
+  );
+  let exitCode = 1;
+  await app.start();
+  if (shouldDropDatabase) {
+    const result = await DatabaseInitializationService.dropDatabase(
+      app.db.connection,
+    );
+    if (result) {
+      debugLog(
+        app.environment.detailedDebug,
+        'log',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_DatabaseDropped),
+      );
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      debugLog(
+        app.environment.detailedDebug,
+        'log',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_ProceedingToDbInitialization),
+      );
+    } else {
+      debugLog(
+        app.environment.detailedDebug,
+        'error',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_Error_FailedToDropDatabase),
+      );
+      await app.stop();
+      process.exit(2);
+    }
+  }
+  debugLog(
+    app.environment.detailedDebug,
+    'log',
+    getSuiteCoreTranslation(SuiteCoreStringKey.Admin_StartingDbInitialization),
+  );
+  const result: IFailableResult<IServerInitResult> =
+    await DatabaseInitializationService.initUserDb(app);
+  if (result.success && result.data) {
+    debugLog(
+      app.environment.debug,
+      'log',
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_UserDatabaseInitialized,
+      ),
+    );
+    if (app.environment.detailedDebug) {
+      DatabaseInitializationService.printServerInitResults(result.data);
+      // DatabaseInitializationService.setEnvFromInitResults(result.data);
+      // app.reloadEnvironment(envDir, true);
+      const initHash = DatabaseInitializationService.serverInitResultHash(
+        result.data,
+      );
+      debugLog(
+        true,
+        'log',
+        `Database initialized with options hash: ${initHash}`,
+      );
+    }
+    exitCode = 0;
+  } else {
+    const engine = getSuiteCoreI18nEngine();
+    console.error(
+      engine.t(
+        '{{SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabase}}:',
+      ),
+      result.error,
+    );
+    exitCode++;
+  }
+  await app.stop();
+  process.exit(exitCode);
+}
+
+main().catch((err) => {
+  const engine = getSuiteCoreI18nEngine();
+  console.error(
+    engine.t('{{SuiteCoreStringKey.Admin_Error_UnhandledErrorInMain}}:'),
+    err,
+  );
+  process.exit(1);
+});

package/scaffolding/lib/src/index.ts.mustache

@@ -0,0 +1,6 @@
+export * from './lib/constants';
+export * from './lib/i18n-setup';
+export * from './lib/enumerations/{{workspaceName}}-string-key';
+export * from './lib/interfaces/constants';
+export * from './lib/strings-collection';
+export * from './lib/ecies-config';

package/scaffolding/lib/src/lib/constants.ts.mustache

@@ -0,0 +1,15 @@
+import { IConstants } from './interfaces/constants';
+import { Constants } from '@digitaldefiance/suite-core-lib';
+
+export const AppConstants: IConstants = {
+  ...Constants,
+  Site: '{{siteTitle}}' as const,
+  SiteTagline: '{{siteTagline}}' as const,
+  SiteDescription: '{{siteDescription}}' as const,
+  SiteHostname: '{{hostname}}' as const, 
+  PasswordRegex: /^(?=.*[A-Za-z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?])[A-Za-z\d!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]{8,}$/,
+  UsernameMinLength: 3 as const,
+  UsernameMaxLength: 30 as const,
+  UsernameRegex: /^[A-Za-z0-9]{3,30}$/,
+  PasswordMinLength: 8 as const,
+};

package/scaffolding/lib/src/lib/ecies-config.ts

@@ -0,0 +1,10 @@
+import { IECIESConfig, ECIES } from '@digitaldefiance/ecies-lib';
+
+export const EciesConfig: IECIESConfig = {
+  curveName: ECIES.CURVE_NAME,
+  primaryKeyDerivationPath: ECIES.PRIMARY_KEY_DERIVATION_PATH,
+  mnemonicStrength: ECIES.MNEMONIC_STRENGTH,
+  symmetricAlgorithm: ECIES.SYMMETRIC_ALGORITHM_CONFIGURATION,
+  symmetricKeyBits: ECIES.SYMMETRIC.KEY_BITS,
+  symmetricKeyMode: ECIES.SYMMETRIC.MODE,
+};

package/scaffolding/lib/src/lib/enumerations/{{workspaceName}}-string-key.ts.mustache

@@ -0,0 +1,5 @@
+export enum {{WorkspaceName}}StringKey {
+  SiteTitle = 'siteTitle',
+  SiteDescription = 'siteDescription',
+  SiteTagline = 'siteTagline',
+}