@digitaldefiance/express-suite-starter 2.3.4 → 2.3.6

package/scaffolding/api-lib/src/lib/models/mnemonic.ts

@@ -0,0 +1,12 @@
+import { BaseModelName, SchemaCollection, IMnemonicDocument, MnemonicSchema } from '@digitaldefiance/node-express-suite';
+import { Connection } from '@digitaldefiance/mongoose-types';
+
+export function MnemonicModel(connection: Connection) {
+  return connection.model<IMnemonicDocument>(
+    BaseModelName.Mnemonic,
+    MnemonicSchema,
+    SchemaCollection.Mnemonic,
+  );
+}
+
+export default MnemonicModel;

package/scaffolding/api-lib/src/lib/models/role.ts

@@ -0,0 +1,12 @@
+import { BaseModelName, SchemaCollection, IRoleDocument, RoleSchema } from '@digitaldefiance/node-express-suite';
+import { Connection } from '@digitaldefiance/mongoose-types';
+
+export function RoleModel(connection: Connection) {
+  return connection.model<IRoleDocument>(
+    BaseModelName.Role,
+    RoleSchema,
+    SchemaCollection.Role,
+  );
+}
+
+export default RoleModel;

package/scaffolding/api-lib/src/lib/models/used-direct-login-token.ts

@@ -0,0 +1,12 @@
+import { BaseModelName, IUsedDirectLoginTokenDocument, SchemaCollection,UsedDirectLoginTokenSchema } from '@digitaldefiance/node-express-suite';
+import { Connection, Model } from '@digitaldefiance/mongoose-types';
+
+export default function UsedDirectLoginTokenModel(
+  connection: Connection,
+): Model<IUsedDirectLoginTokenDocument> {
+  return connection.model<IUsedDirectLoginTokenDocument>(
+    BaseModelName.UsedDirectLoginToken,
+    UsedDirectLoginTokenSchema,
+    SchemaCollection.UsedDirectLoginToken,
+  );
+}

package/scaffolding/api-lib/src/lib/models/user-role.ts

@@ -0,0 +1,12 @@
+import { SchemaCollection, IUserRoleDocument, UserRoleSchema, BaseModelName } from '@digitaldefiance/node-express-suite';
+import { Connection, Model } from '@digitaldefiance/mongoose-types';
+
+export default function UserRoleModel(
+  connection: Connection,
+): Model<IUserRoleDocument> {
+  return connection.model<IUserRoleDocument>(
+    BaseModelName.UserRole,
+    UserRoleSchema,
+    SchemaCollection.UserRole,
+  );
+}

package/scaffolding/api-lib/src/lib/models/user.ts

@@ -0,0 +1,14 @@
+import { Connection } from '@digitaldefiance/mongoose-types';
+import { IUserDocument } from '../documents/user';
+import { UserSchema } from '../schemas/user';
+import { BaseModelName, SchemaCollection } from '@digitaldefiance/node-express-suite';
+
+export function UserModel(connection: Connection) {
+  return connection.model<IUserDocument>(
+    BaseModelName.User,
+    UserSchema,
+    SchemaCollection.User,
+  );
+}
+
+export default UserModel;

package/scaffolding/api-lib/src/lib/routers/api.ts

@@ -0,0 +1,23 @@
+import { ApiRouter as BaseApiRouter, IApplication, IBaseDocument } from '@digitaldefiance/node-express-suite';
+import { ITokenRole, ITokenUser, IUserBase } from '@digitaldefiance/suite-core-lib';
+import { Types } from '@digitaldefiance/mongoose-types';
+import { Environment } from '../environment';
+import { IConstants } from '../interfaces/constants';
+
+export class ApiRouter<
+  I extends Types.ObjectId | string = Types.ObjectId,
+  D extends Date = Date,
+  S extends string = string,
+  A extends string = string,
+  TUser extends IUserBase<I, D, S, A> = IUserBase<I, D, S, A>,
+  TTokenRole extends ITokenRole<I, D> = ITokenRole<I, D>,
+  TTokenUser extends ITokenUser = ITokenUser,
+  TEnvironment extends Environment = Environment,
+  TConstants extends IConstants = IConstants,
+  TBaseDocument extends IBaseDocument<any, Types.ObjectId> = IBaseDocument<any, Types.ObjectId>,
+  TApplication extends IApplication = IApplication,
+> extends BaseApiRouter<I,D,S,A, TUser,TTokenRole,TBaseDocument, TTokenUser,TConstants, TEnvironment, TApplication> {
+  constructor(app: TApplication) {
+    super(app);
+  }
+}

package/scaffolding/api-lib/src/lib/routers/app.ts

@@ -0,0 +1,31 @@
+import { AppRouter as BaseAppRouter, BaseRouter, IApplication } from '@digitaldefiance/node-express-suite';
+import { Request, Response, NextFunction } from 'express';
+import { Environment } from '../environment';
+import { IConstants } from '../interfaces/constants';
+import { Constants } from '../constants';
+
+export class AppRouter extends BaseAppRouter<IApplication> {
+  constructor(apiRouter: BaseRouter<IApplication>) {
+    super(apiRouter);
+  }
+
+  public override renderIndex(req: Request, res: Response, next: NextFunction): void {
+    if (req.url.endsWith('.js')) {
+      res.type('application/javascript');
+    }
+
+    const jsFile = this.getAssetFilename(this.assetsDir, /^index-.*\.js$/);
+    const cssFile = this.getAssetFilename(this.assetsDir, /^index-.*\.css$/);
+    const constants = this.application.constants as IConstants;
+    const environment = this.application.environment as Environment;
+    const SiteName = constants.Site;
+    const locals = {
+      ...this.getBaseViewLocals(req, res),
+      title: SiteName,
+      jsFile: jsFile ? `assets/${jsFile}` : undefined,
+      cssFile: cssFile ? `assets/${cssFile}` : undefined,
+    };
+
+    this.renderTemplate(req, res, next, 'index', locals);
+  }
+}

package/scaffolding/api-lib/src/lib/routers/index.ts

@@ -0,0 +1,2 @@
+export * from './api';
+export * from './app';

package/scaffolding/api-lib/src/lib/schemas/index.ts

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './user';

package/scaffolding/api-lib/src/lib/schemas/schema.ts

@@ -0,0 +1,53 @@
+import { Connection } from '@digitaldefiance/mongoose-types';
+import { BaseModelName, createEmailTokenSchema, createMnemonicSchema, createRoleSchema, createUsedDirectLoginTokenSchema, createUserRoleSchema, MnemonicSchema, RoleSchema, SchemaCollection, SchemaMap, UsedDirectLoginTokenSchema, UserRoleSchema } from '@digitaldefiance/node-express-suite';
+import EmailTokenModel from '../models/email-token';
+import MnemonicModel from '../models/mnemonic';
+import RoleModel from '../models/role';
+import UsedDirectLoginTokenModel from '../models/used-direct-login-token';
+import UserModel from '../models/user';
+import UserRoleModel from '../models/user-role';
+import { UserSchema } from './user';
+import { ModelDocMap } from '../shared-types';
+import { IConstants } from '../interfaces/constants';
+import { Constants } from '../constants';
+
+export function getSchemaMap(connection: Connection, constants: IConstants = Constants): SchemaMap<ModelDocMap> {
+  return {
+    EmailToken: {
+      collection: SchemaCollection.EmailToken,
+      model: EmailTokenModel(connection),
+      modelName: BaseModelName.EmailToken,
+      schema: createEmailTokenSchema(undefined, constants),
+    },
+    Mnemonic: {
+      collection: SchemaCollection.Mnemonic,
+      model: MnemonicModel(connection),
+      modelName: BaseModelName.Mnemonic,
+      schema: createMnemonicSchema(undefined, constants),
+    },
+    Role: {
+      collection: SchemaCollection.Role,
+      model: RoleModel(connection),
+      modelName: BaseModelName.Role,
+      schema: createRoleSchema(undefined, constants),
+    },
+    UsedDirectLoginToken: {
+      collection: SchemaCollection.UsedDirectLoginToken,
+      model: UsedDirectLoginTokenModel(connection),
+      modelName: BaseModelName.UsedDirectLoginToken,
+      schema: createUsedDirectLoginTokenSchema(undefined, constants),
+    },
+    User: {
+      collection: SchemaCollection.User,
+      model: UserModel(connection),
+      modelName: BaseModelName.User,
+      schema: UserSchema,
+    },
+    UserRole: {
+      collection: SchemaCollection.UserRole,
+      model: UserRoleModel(connection),
+      modelName: BaseModelName.UserRole,
+      schema: createUserRoleSchema(undefined, constants),
+    },
+  };
+}

package/scaffolding/api-lib/src/lib/schemas/user.ts

@@ -0,0 +1,13 @@
+import { createUserSchema, IConstants } from '@digitaldefiance/node-express-suite';
+import { Constants } from '../constants';
+import { Schema } from '@digitaldefiance/mongoose-types';
+import { IUserDocument } from '../documents';
+
+// Clone base schema and extend
+const BaseUserSchema = createUserSchema<IConstants>(undefined, undefined, undefined, undefined, undefined, Constants);
+export const UserSchema: Schema<IUserDocument> = BaseUserSchema.clone();
+
+// // Add site-specific fields
+// UserSchema.add(
+//   {
+// });

package/scaffolding/api-lib/src/lib/services/email.ts

@@ -0,0 +1,109 @@
+import { SESClient, SendEmailCommand } from '@aws-sdk/client-ses';
+import { IApplication, IBaseDocument } 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 { Types } from '@digitaldefiance/mongoose-types';
+import { Environment } from '../environment';
+import { IConstants } from '../interfaces/constants';
+
+/**
+ * A generic service for sending emails using Amazon SES.
+ */
+export class EmailService {
+  private readonly sesClient: SESClient;
+  private readonly emailSender: string;
+  private readonly disableEmailSend: boolean;
+  private readonly debug: boolean;
+  private readonly application: IApplication;
+
+  /**
+   * Constructs an instance of EmailService.
+   * @param config Configuration object containing AWS credentials, region, sender email, and debug/disable flags.
+   */
+  constructor(application: IApplication) {
+    this.application = application;
+    const environment = application.environment as Environment;
+    this.emailSender = environment.emailSender;
+    this.disableEmailSend = environment.disableEmailSend;
+    this.debug = environment.debug;
+
+    // Initialize the SES client with provided AWS credentials and region.
+    this.sesClient = new SESClient({
+      region: environment.aws.region,
+      credentials: {
+        accessKeyId: environment.aws.accessKeyId.value ?? '',
+        secretAccessKey:
+          environment.aws.secretAccessKey.value ?? '',
+      },
+    });
+  }
+
+  /**
+   * Sends an email using Amazon SES.
+   * @param to The recipient's email address.
+   * @param subject The subject line of the email.
+   * @param text The plain text body of the email.
+   * @param html The HTML body of the email.
+   * @returns A Promise that resolves when the email is sent successfully, or rejects on failure.
+   * @throws Error if email sending is disabled or if SES encounters an error.
+   */
+  public async sendEmail(
+    to: string,
+    subject: string,
+    text: string,
+    html: string,
+  ): Promise<void> {
+    if (this.disableEmailSend) {
+      debugLog(
+        this.debug,
+        'log',
+        `Email sending disabled for: ${to} - Subject: ${subject}`,
+      );
+      return;
+    }
+
+    const sendCommand = new SendEmailCommand({
+      Destination: {
+        ToAddresses: [to], // Recipient email address
+      },
+      Message: {
+        Body: {
+          Html: {
+            Charset: 'UTF-8',
+            Data: html, // HTML content of the email
+          },
+          Text: {
+            Charset: 'UTF-8',
+            Data: text, // Plain text content of the email
+          },
+        },
+        Subject: {
+          Charset: 'UTF-8',
+          Data: subject, // Subject of the email
+        },
+      },
+      Source: this.emailSender, // Sender email address (must be verified in SES)
+    });
+
+    try {
+      await this.sesClient.send(sendCommand);
+      debugLog(
+        this.debug,
+        'log',
+        `Email sent successfully to ${to} with subject: ${subject}`,
+      );
+    } catch (error) {
+      console.error(`Failed to send email to ${to}:`, error);
+      throw new Error(
+        `Failed to send email: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      );
+    }
+  }
+}

package/scaffolding/api-lib/src/lib/services/index.ts

@@ -0,0 +1 @@
+export * from './email';

package/scaffolding/api-lib/src/lib/shared-types.ts

@@ -0,0 +1,172 @@
+import { NextFunction, Request, RequestHandler, Response } from 'express';
+import { ValidationChain } from 'express-validator';
+import { ClientSession, Document, Model, Types } from '@digitaldefiance/mongoose-types';
+import { Brand } from 'ts-brand';
+import type { IUserDocument } from './documents/user';
+import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
+import { IKeyPairBufferWithUnEncryptedPrivateKey, ISigningKeyPrivateKeyInfo, ISimplePublicKeyOnly, ISimpleKeyPairBuffer, ISimplePublicKeyOnlyBuffer } from '@digitaldefiance/node-ecies-lib'
+import {IApiErrorResponse, IApiMessageResponse, ISchema, IStatusCodeResponse, IApiExpressValidationErrorResponse, IApiMongoValidationErrorResponse, IUserRoleDocument, IUsedDirectLoginTokenDocument, IRoleDocument, IMnemonicDocument, IEmailTokenDocument } from '@digitaldefiance/node-express-suite';
+
+export type DefaultBackendIdType = Types.ObjectId;
+
+export type MongooseDocument = Document;
+export type MongooseModel<
+  TRawDocType,
+  TQueryHelpers = {},
+  TInstanceMethods = {},
+  TVirtuals = {},
+> = Model<TRawDocType, TQueryHelpers, TInstanceMethods, TVirtuals>;
+
+/**
+ * Transaction callback type for withTransaction
+ */
+export type TransactionCallback<T> = (
+  session: ClientSession | undefined,
+  ...args: Array<unknown>
+) => Promise<T>;
+
+/**
+ * Validated body for express-validator
+ */
+export type ValidatedBody<T extends string> = {
+  [K in T]: unknown;
+};
+
+/**
+ * Schema map interface
+ */
+export type ModelDocMap = {
+  EmailToken: IEmailTokenDocument;
+  Mnemonic: IMnemonicDocument;
+  Role: IRoleDocument;
+  UsedDirectLoginToken: IUsedDirectLoginTokenDocument;
+  User: IUserDocument;
+  UserRole: IUserRoleDocument;
+};
+
+export type SchemaMap = {
+  /**
+   * For each model name, contains the corresponding schema and model
+   */
+  [K in keyof ModelDocMap]: ISchema<ModelDocMap[K]>;
+};
+
+export type ApiRequestHandler<T extends ApiResponse> = (
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) => Promise<IStatusCodeResponse<T>>;
+
+export type TypedHandlers = {
+  [key: string]: ApiRequestHandler<ApiResponse>;
+};
+
+export interface IRouteDefinition<T extends TypedHandlers> {
+  method: 'get' | 'post' | 'put' | 'delete' | 'patch';
+  path: string;
+  options: {
+    handlerKey: keyof T;
+    validation?: (validationLanguage: CoreLanguageCode) => ValidationChain[];
+    useAuthentication: boolean;
+    useCryptoAuthentication: boolean;
+  };
+}
+
+export type RouteHandlers = Record<string, ApiRequestHandler<ApiResponse>>;
+
+export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch';
+
+export interface RouteConfig<H extends object> {
+  method: HttpMethod;
+  path: string;
+  handlerKey: keyof H;
+  handlerArgs?: Array<unknown>;
+  useAuthentication: boolean;
+  useCryptoAuthentication: boolean;
+  middleware?: RequestHandler[];
+  validation?: FlexibleValidationChain;
+  rawJsonHandler?: boolean;
+  authFailureStatusCode?: number;
+}
+
+export function routeConfig<T extends object>(
+  method: 'get' | 'post' | 'put' | 'delete' | 'patch',
+  path: string,
+  options: {
+    handlerKey: keyof T;
+    validation?: (validationLanguage: CoreLanguageCode) => ValidationChain[];
+    useAuthentication: boolean;
+    useCryptoAuthentication: boolean;
+  },
+): RouteConfig<T> {
+  return {
+    method,
+    path,
+    handlerKey: options.handlerKey,
+    validation: options.validation,
+    useAuthentication: options.useAuthentication,
+    useCryptoAuthentication: options.useCryptoAuthentication,
+  };
+}
+
+export type THandlerArgs<T extends Array<unknown>> = T;
+
+export type FlexibleValidationChain =
+  | ValidationChain[]
+  | ((lang: CoreLanguageCode) => ValidationChain[]);
+
+export type JsonPrimitive = string | number | boolean | null | undefined;
+
+export type JsonResponse =
+  | JsonPrimitive
+  | { [key: string]: JsonResponse }
+  | JsonResponse[];
+
+export type ApiErrorResponse =
+  | IApiErrorResponse
+  | IApiExpressValidationErrorResponse
+  | IApiMongoValidationErrorResponse;
+
+export type ApiResponse = IApiMessageResponse | ApiErrorResponse | JsonResponse;
+
+export type SendFunction<T extends ApiResponse> = (
+  statusCode: number,
+  data: T,
+  res: Response<T>,
+) => void;
+
+export type KeyPairBufferWithUnEncryptedPrivateKey = Brand<
+  IKeyPairBufferWithUnEncryptedPrivateKey,
+  'KeyPairBufferWithUnEncryptedPrivateKey'
+>;
+export type SigningKeyPrivateKeyInfo = Brand<
+  ISigningKeyPrivateKeyInfo,
+  'SigningKeyPrivateKeyInfo'
+>;
+export type SimpleKeyPair = Brand<SimplePublicKeyOnly, 'SimpleKeyPair'>;
+export type SimplePublicKeyOnly = Brand<
+  ISimplePublicKeyOnly,
+  'SimplePublicKeyOnly'
+>;
+export type SimpleKeyPairBuffer = Brand<
+  ISimpleKeyPairBuffer,
+  'SimpleKeyPairBuffer'
+>;
+export type SimplePublicKeyOnlyBuffer = Brand<
+  ISimplePublicKeyOnlyBuffer,
+  'SimplePublicKeyOnlyBuffer'
+>;
+export type HexString = Brand<string, 'HexString'>;
+export type SignatureString = Brand<HexString, 'SignatureString'>;
+export type SignatureBuffer = Buffer & Brand<Buffer, 'SignatureBuffer'>;
+export type ChecksumBuffer = Buffer &
+  Brand<Buffer, 'Sha3Checksum', 'ChecksumBuffer'>;
+export type ChecksumString = Brand<HexString, 'Sha3Checksum', 'ChecksumString'>;
+
+/**
+ * Extended Buffer type for data
+ */
+export type DataBuffer = Buffer & {
+  toBuffer(): Buffer;
+  toHex(): string;
+};

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

@@ -0,0 +1,3 @@
+MONGO_PASSWORD={{password}}
+MONGO_INITDB_DATABASE={{workspaceName}}
+COMPOSE_PROJECT_NAME={{prefix}}_devcontainer

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

@@ -0,0 +1,6 @@
+FROM mcr.microsoft.com/devcontainers/javascript-node:20
+
+# Install MongoDB tools
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -y mongodb-clients \
+    && apt-get clean -y && rm -rf /var/lib/apt/lists/*

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

@@ -0,0 +1,31 @@
+{
+  "name": "{{workspaceName}} - Node.js & MongoDB",
+  "dockerComposeFile": "docker-compose.yml",
+  "service": "app",
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "mongodb.mongodb-vscode",
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode",
+        "firsttris.vscode-jest-runner",
+        "nrwl.angular-console"
+      ]
+    }
+  },
+  "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"    
+  ],
+  "forwardPorts": [3000, 3443, 4200, 27017],
+  "postCreateCommand": "yarn install"
+}

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

@@ -0,0 +1,31 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    volumes:
+      - ../..:/workspaces:cached
+    command: sleep infinity
+    network_mode: service:db
+    dns:
+      - 1.1.1.1
+      - 8.8.8.8 
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    # Add memory limits to prevent OOM kills
+    mem_limit: 16g
+    memswap_limit: 16g
+    cpus: 4
+
+  db:
+    image: mongo:8
+    restart: unless-stopped
+    volumes:
+      - mongodb-data:/data/db
+    environment:
+      MONGO_INITDB_ROOT_USERNAME: admin
+      MONGO_INITDB_ROOT_PASSWORD: ${MONGO_PASSWORD}
+      MONGO_INITDB_DATABASE: ${MONGO_INITDB_DATABASE}
+
+volumes:
+  mongodb-data:

package/scaffolding/devcontainer-mongodb/.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/.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-mongodb-replicaset/.devcontainer/.env.example

@@ -0,0 +1,14 @@
+MONGO_INITDB_ROOT_USERNAME=admin
+MONGO_INITDB_ROOT_PASSWORD={{password}}
+MONGO_INITDB_DATABASE={{workspaceName}}
+MONGO_REPLICA_SET_NAME=rs0
+MONGO_PORT=27017
+MONGO_KEYFILE=/tmp/replica.key
+MONGO_DB_PATH=/data/db
+DEFAULT_YARN_VERSION=4.11.0
+DEFAULT_NVM_VERSION=22
+GIT_EMAIL=your@email.com
+GIT_NAME="Your Name"
+DEBUG="false"
+
+COMPOSE_PROJECT_NAME={{prefix}}_devcontainer