@digitaldefiance/express-suite-starter 3.0.1 → 3.0.3

package/README.md

@@ -1,6 +1,6 @@
 # Node Express Suite Starter
 
-<a alt="Nx logo" href="https://nx.dev" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-logo.png" width="45"></a>
+<img src="assets/albatross.svg" style="height: 200px;" />
 
 Automated generator for MERN stack monorepos using [@digitaldefiance/node-express-suite](https://www.npmjs.com/package/@digitaldefiance/node-express-suite).
 
@@ -25,6 +25,20 @@ Part of [Express Suite](https://github.com/Digital-Defiance/express-suite)
 - ✅ **Validation** - Post-generation checks with fix suggestions
 - 🖥️ **Cross-Platform** - Windows, macOS, and Linux support
 
+**Express Suite** is a comprehensive TypeScript framework providing a complete foundation for building secure, scalable, and internationalized web applications. It integrates enterprise-grade cryptography, multi-language internationalization, and a full-stack MERN framework—all structured as modular packages for modern development workflows.
+
+Formerly known as **Project Albatross**, the suite draws inspiration from the great albatross bird, symbolizing endurance and the ability to traverse vast distances—qualities reflected in the suite's goal to deliver far-reaching, reliable solutions.
+
+Express Suite Starter is a scaffolding generator which can produce fully functional application boilerplate using all of Express Suite's features (internationalization, mnemonic login, backup codes, etc):
+
+<img width="1071" height="1051" alt="Screenshot 2026-02-22 at 11 39 01 AM" src="https://github.com/user-attachments/assets/5cc74425-aa8a-4a10-94f1-5a1e2979b646" />
+
+<img width="1071" height="1051" alt="Screenshot 2026-02-22 at 11 40 09 AM" src="https://github.com/user-attachments/assets/4b6c9c13-9452-4fa2-9356-5cdd1f26f42d" />
+
+<img width="1071" height="1051" alt="Screenshot 2026-02-22 at 11 40 19 AM" src="https://github.com/user-attachments/assets/2ef7614f-fa96-4af5-843b-663a5322bc38" />
+
+<img width="1071" height="1051" alt="Screenshot 2026-02-22 at 11 39 50 AM" src="https://github.com/user-attachments/assets/92dda51f-204e-4e1a-84bb-367b6bd0a44a" />
+
 ## Quick Start
 
 ### NPX (Recommended)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/express-suite-starter",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "license": "MIT",
   "bin": {
     "create-express-suite": "./dist/src/cli.js"

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

@@ -1,13 +1,13 @@
 import { Types } from '@digitaldefiance/mongoose-types';
 import { AccountStatus, IUserBase } from '@digitaldefiance/suite-core-lib';
-import { IBaseDocument } from '@digitaldefiance/node-express-suite';
+import { BaseDocument } from '@digitaldefiance/node-express-suite';
 import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
 import { PlatformID } from '@digitaldefiance/node-ecies-lib';
 
 /**
  * Composite interface for user collection documents
  */
-export interface IUserDocument<TID extends PlatformID = PlatformID, TDate extends Date = Date, TLanguage extends string = CoreLanguageCode, TAccountStatus extends AccountStatus = AccountStatus> extends IBaseDocument<
+export interface IUserDocument<TID extends PlatformID = PlatformID, TDate extends Date = Date, TLanguage extends string = CoreLanguageCode, TAccountStatus extends AccountStatus = AccountStatus> extends BaseDocument<
   IUserBase<
     TID,
     TDate,

package/scaffolding/api-lib/src/lib/models/email-token.ts

@@ -1,8 +1,8 @@
-import { BaseModelName, SchemaCollection, IEmailTokenDocument, EmailTokenSchema } from '@digitaldefiance/node-express-suite';
+import { BaseModelName, SchemaCollection, EmailTokenDocument, EmailTokenSchema } from '@digitaldefiance/node-express-suite';
 import { Connection } from '@digitaldefiance/mongoose-types';
 
 export function EmailTokenModel(connection: Connection) {
-  return connection.model<IEmailTokenDocument>(
+  return connection.model<EmailTokenDocument>(
     BaseModelName.EmailToken,
     EmailTokenSchema,
     SchemaCollection.EmailToken,

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

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

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

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

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

@@ -1,10 +1,10 @@
-import { BaseModelName, IUsedDirectLoginTokenDocument, SchemaCollection,UsedDirectLoginTokenSchema } from '@digitaldefiance/node-express-suite';
+import { BaseModelName, UsedDirectLoginTokenDocument, 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>(
+): Model<UsedDirectLoginTokenDocument> {
+  return connection.model<UsedDirectLoginTokenDocument>(
     BaseModelName.UsedDirectLoginToken,
     UsedDirectLoginTokenSchema,
     SchemaCollection.UsedDirectLoginToken,

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

@@ -1,10 +1,10 @@
-import { SchemaCollection, IUserRoleDocument, UserRoleSchema, BaseModelName } from '@digitaldefiance/node-express-suite';
+import { SchemaCollection, UserRoleDocument, 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>(
+): Model<UserRoleDocument> {
+  return connection.model<UserRoleDocument>(
     BaseModelName.UserRole,
     UserRoleSchema,
     SchemaCollection.UserRole,

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

@@ -1,5 +1,5 @@
 import { SESClient, SendEmailCommand } from '@aws-sdk/client-ses';
-import { IApplication, IBaseDocument } from '@digitaldefiance/node-express-suite';
+import { IApplication, BaseDocument } from '@digitaldefiance/node-express-suite';
 
 // Simple debugLog implementation
 function debugLog(debug: boolean, type: 'log' | 'warn' | 'error', ...args: any[]): void {

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

@@ -5,7 +5,7 @@ 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';
+import {IApiErrorResponse, IApiMessageResponse, ISchema, IStatusCodeResponse, IApiExpressValidationErrorResponse, IApiMongoValidationErrorResponse, UserRoleDocument, UsedDirectLoginTokenDocument, RoleDocument, MnemonicDocument, EmailTokenDocument } from '@digitaldefiance/node-express-suite';
 
 export type DefaultBackendIdType = Types.ObjectId;
 
@@ -36,12 +36,12 @@ export type ValidatedBody<T extends string> = {
  * Schema map interface
  */
 export type ModelDocMap = {
-  EmailToken: IEmailTokenDocument;
-  Mnemonic: IMnemonicDocument;
-  Role: IRoleDocument;
-  UsedDirectLoginToken: IUsedDirectLoginTokenDocument;
+  EmailToken: EmailTokenDocument;
+  Mnemonic: MnemonicDocument;
+  Role: RoleDocument;
+  UsedDirectLoginToken: UsedDirectLoginTokenDocument;
   User: IUserDocument;
-  UserRole: IUserRoleDocument;
+  UserRole: UserRoleDocument;
 };
 
 export type SchemaMap = {

package/scaffolding/react/src/app/app.tsx.mustache

@@ -6,7 +6,7 @@ import { Route, Routes, useNavigate } from 'react-router-dom';
 import '../styles.scss';
 import SplashPage from './pages/SplashPage';
 import { createAppTheme } from './theme.tsx';
-import { AppThemeProvider, DashboardPage, MenuProvider, I18nProvider as TranslationProvider, AuthProvider, SuiteConfigProvider, ApiAccess, ChangePasswordFormWrapper, VerifyEmailPageWrapper, RegisterFormWrapper, UserSettingsFormWrapper, LogoutPageWrapper, LoginFormWrapper, PrivateRoute, UnAuthRoute, TopMenu, TranslatedTitle, BackupCodeLoginWrapper, BackupCodesWrapper } from '@digitaldefiance/express-suite-react-components';
+import { AppThemeProvider, DashboardPage, MenuProvider, I18nProvider as TranslationProvider, AuthProvider, SuiteConfigProvider, ApiAccess, ChangePasswordFormWrapper, VerifyEmailPageWrapper, RegisterFormWrapper, UserSettingsFormWrapper, LogoutPageWrapper, LoginFormWrapper, PrivateRoute, UnAuthRoute, TopMenu, TranslatedTitle, BackupCodeLoginWrapper, BackupCodesWrapper, ForgotPasswordFormWrapper, ResetPasswordFormWrapper } from '@digitaldefiance/express-suite-react-components';
 import { environment } from '../environments/environment';
 import { {{WorkspaceName}}StringKey, ComponentId, i18nEngine } from '{{namespace}}/lib';
 import AlbatrossLogo from '../assets/albatross.svg';
@@ -96,6 +96,22 @@ const InnerApp: FC = () => {
               </PrivateRoute>
             }
           />
+          <Route
+            path="/forgot-password"
+            element={
+              <UnAuthRoute>
+                <ForgotPasswordFormWrapper />
+              </UnAuthRoute>
+            }
+          />
+          <Route
+            path="/reset-password"
+            element={
+              <UnAuthRoute>
+                <ResetPasswordFormWrapper />
+              </UnAuthRoute>
+            }
+          />
           <Route path="/backup-code" element={<BackupCodeLoginWrapper />} />
           <Route
             path="/backup-codes"