@digitaldefiance/express-suite-starter 2.3.4 → 2.3.6

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/Dockerfile

@@ -0,0 +1,38 @@
+FROM mcr.microsoft.com/devcontainers/javascript-node:1-22-bookworm
+
+# Install MongoDB command line tools - though mongo-database-tools not available on arm64
+ARG MONGO_TOOLS_VERSION=6.0
+RUN . /etc/os-release \
+    && curl -sSL "https://www.mongodb.org/static/pgp/server-${MONGO_TOOLS_VERSION}.asc" | gpg --dearmor > /usr/share/keyrings/mongodb-archive-keyring.gpg \
+    && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/mongodb-archive-keyring.gpg] http://repo.mongodb.org/apt/debian ${VERSION_CODENAME}/mongodb-org/${MONGO_TOOLS_VERSION} main" | tee /etc/apt/sources.list.d/mongodb-org-${MONGO_TOOLS_VERSION}.list \
+    && apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -y mongodb-mongosh libnss3-tools golang \
+    && if [ "$(dpkg --print-architecture)" = "amd64" ]; then apt-get install -y mongodb-database-tools; fi \
+    && apt-get clean -y && rm -rf /var/lib/apt/lists/*
+
+# [Optional] Uncomment this section to install additional OS packages.
+# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+#     && apt-get -y install --no-install-recommends <your-package-list-here>
+
+# [Optional] Uncomment if you want to install an additional version of node using nvm
+# ARG EXTRA_NODE_VERSION=10
+# RUN su node -c "source /usr/local/share/nvm/nvm.sh && nvm install ${EXTRA_NODE_VERSION}"
+
+# [Optional] Uncomment if you want to install more global node modules
+# RUN su node -c "npm install -g <your-package-list-here>"
+
+RUN git clone https://github.com/FiloSottile/mkcert && cd mkcert && go build -ldflags "-X main.Version=$(git describe --tags)" && cp mkcert /usr/local/bin && cd .. && rm -rf mkcert && /usr/local/bin/mkcert -install
+
+# Install global npm packages and setup corepack
+RUN npm install -g nx @angular/cli typescript ts-node nodemon && \
+    corepack enable && \
+    corepack prepare yarn@4.9.2 --activate
+
+# Copy and set up custom entrypoint for better signal handling
+COPY entrypoint.sh /usr/local/bin/entrypoint.sh
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
+RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" && unzip awscliv2.zip && sudo ./aws/install && rm -rf awscliv2.zip aws
+
+# Set the entrypoint
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/Mongo.Dockerfile

@@ -0,0 +1,24 @@
+# db/Mongo.Dockerfile
+
+FROM mongo:latest
+
+# Generate a secure key for the replica set
+RUN openssl rand -base64 756 > "/tmp/replica.key" \
+  && chmod 600 /tmp/replica.key \
+  && chown mongodb:mongodb /tmp/replica.key
+
+# Remove any existing init scripts to prevent conflicts
+RUN rm -rf /docker-entrypoint-initdb.d/*
+
+# Copy the updated entrypoint script
+COPY mongodb_entrypoint.sh /usr/local/bin/mongodb_entrypoint.sh
+RUN chmod +x /usr/local/bin/mongodb_entrypoint.sh
+
+COPY mongodb_healthcheck.sh /usr/local/bin/mongodb_healthcheck.sh
+RUN chmod +x /usr/local/bin/mongodb_healthcheck.sh
+
+# Override the default entrypoint
+ENTRYPOINT ["/usr/local/bin/mongodb_entrypoint.sh"]
+
+# Expose MongoDB port
+EXPOSE 27017

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/devcontainer.json

@@ -0,0 +1,69 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/javascript-node-mongo
+{
+  "name": "Node.js & Mongo DB",
+  "dockerComposeFile": "docker-compose.yml",
+  "service": "app",
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
+    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
+  },
+  // Add container environment variables to help with stability
+  "containerEnv": {
+    "COREPACK_ENABLE_DOWNLOAD_PROMPT": "0",
+    "VSCODE_REMOTE_CONTAINERS_SESSION": "${containerSessionId}"
+  },
+  // You can also add hostRequirements to check if the host has enough memory
+  "hostRequirements": {
+    "memory": "16gb",
+    "cpus": 4
+  },
+  "runArgs": [
+    "--memory=12g",
+    "--memory-swap=16g",
+    "--cpus=4",
+    "--dns=1.1.1.1",
+    "--dns=8.8.8.8",
+    "--add-host=host.docker.internal:host-gateway"
+  ],
+  // Configure tool-specific properties.
+  "customizations": {
+    // Configure properties specific to VS Code.
+    "vscode": {
+      // Add the IDs of extensions you want installed when the container is created.
+      "extensions": [
+        "mongodb.mongodb-vscode",
+        "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"
+      ]
+    }
+  },
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  "forwardPorts": [
+    3000,
+    3443,
+    4200,
+    27017
+  ],
+  // Use 'postCreateCommand' to run commands after the container is created.
+  "postCreateCommand": "./.devcontainer/post-create.sh",
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  "remoteUser": "node",
+  // Add connection timeout and retry settings
+  "shutdownAction": "none",
+  "userEnvProbe": "none",
+  "updateRemoteUserUID": false,
+  "remoteEnv": {
+    "SHELL": "/bin/bash"
+  },
+  "overrideCommand": false,
+}

package/scaffolding/devcontainer-mongodb-replicaset/.devcontainer/docker-compose.yml

@@ -0,0 +1,66 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    volumes:
+      - ../..:/workspaces:cached
+    command: ["sleep", "infinity"]
+    dns:
+      - 1.1.1.1
+      - 8.8.8.8
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    # Add init system for better signal handling
+    init: true
+    # Add restart policy
+    restart: unless-stopped
+    # Add memory limits to prevent OOM kills
+    mem_limit: 16g
+    memswap_limit: 16g
+    cpus: 4
+    # Add environment variables for debugging
+    environment:
+      - DB_HOST=db:27017
+      - DEBUG=1
+      - CONTAINER_ROLE=app
+    env_file:
+      - .env
+    depends_on:
+      - db
+    ports:
+      - "3000:3000"
+
+  db:
+    build:
+      context: .
+      dockerfile: ./Mongo.Dockerfile
+    container_name: db          # Ensures the container name is 'db'
+    hostname: db                 # Sets the internal hostname to 'db'
+    restart: unless-stopped
+    # Add memory limits to prevent OOM kills
+    mem_limit: 2g
+    memswap_limit: 2g
+    healthcheck:
+      test: ["CMD", "bash", "/usr/local/bin/mongodb_healthcheck.sh"]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 40s
+    ports:
+      - "27017:27017"
+    volumes:
+      - mongodb-data:/data/db
+    environment:
+      - MONGO_INITDB_ROOT_USERNAME=${MONGO_INITDB_ROOT_USERNAME} 
+      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_INITDB_ROOT_PASSWORD}
+      - MONGO_INITDB_DATABASE=${MONGO_INITDB_DATABASE}
+      - MONGO_REPLICA_SET_NAME=${MONGO_REPLICA_SET_NAME}
+      - MONGO_PORT=${MONGO_PORT}
+      - MONGO_KEYFILE=${MONGO_KEYFILE}
+      - MONGO_DB_PATH=${MONGO_DB_PATH}
+      - DB_HOST=127.0.0.1:27017
+      - EDITOR=vim
+
+volumes:
+  mongodb-data:

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

@@ -0,0 +1,29 @@
+#!/bin/bash
+set -e
+
+# Print debug info
+echo "Container started. PID: $$"
+echo "Arguments: $@"
+echo "Environment:"
+env | grep -E "(VSCODE|REMOTE)" || true
+
+# Set up signal handlers for graceful shutdown
+trap 'echo "Received SIGTERM, shutting down gracefully..."; exit 0' TERM
+trap 'echo "Received SIGINT, shutting down gracefully..."; exit 0' INT
+
+# Start the original command in background
+if [ $# -gt 0 ]; then
+    echo "Executing: $@"
+    "$@" &
+    CHILD_PID=$!
+    echo "Child process started with PID: $CHILD_PID"
+    
+    # Wait for child process and handle signals
+    wait $CHILD_PID
+    EXIT_CODE=$?
+    echo "Child process exited with code: $EXIT_CODE"
+    exit $EXIT_CODE
+else
+    echo "No command provided, running sleep infinity"
+    exec sleep infinity
+fi

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