@digitaldefiance/node-express-suite 3.6.19 → 3.6.21

package/src/errors/express-validation.ts

@@ -0,0 +1,21 @@
+import { TranslatableGenericError } from '@digitaldefiance/i18n-lib';
+import {
+  SuiteCoreComponentId,
+  SuiteCoreStringKey,
+} from '@digitaldefiance/suite-core-lib';
+import { Result, ValidationError } from 'express-validator';
+
+export class ExpressValidationError extends TranslatableGenericError<SuiteCoreStringKey> {
+  public readonly errors: Result<ValidationError> | ValidationError[];
+  public readonly statusCode?: number = 422;
+  constructor(errors: Result<ValidationError> | ValidationError[]) {
+    const errorsArray = Array.isArray(errors) ? errors : errors.array();
+    const _errorCount = errorsArray.length;
+    super(
+      SuiteCoreComponentId,
+      SuiteCoreStringKey.Validation_ExpressValidationFailed,
+    );
+    this.errors = errors;
+    this.name = 'ExpressValidationError';
+  }
+}

package/src/errors/{index.d.ts → index.ts}

@@ -10,4 +10,3 @@ export * from './model-not-registered';
 export * from './mongoose-validation';
 export * from './symmetric';
 export * from './token-expired';
-//# sourceMappingURL=index.d.ts.map

package/src/errors/invalid-backup-code-version.ts

@@ -0,0 +1,15 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class InvalidBackupCodeVersionError extends TranslatableSuiteError {
+  public readonly version: string;
+  constructor(version: string) {
+    super(SuiteCoreStringKey.Error_InvalidBackupCodeVersionTemplate, {
+      version,
+    });
+    this.version = version;
+    this.name = 'InvalidBackupCodeVersionError';
+  }
+}

package/src/errors/invalid-jwt-token.ts

@@ -0,0 +1,11 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteHandleableError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class InvalidJwtTokenError extends TranslatableSuiteHandleableError {
+  constructor() {
+    super(SuiteCoreStringKey.Validation_InvalidToken, { statusCode: 401 });
+    this.name = 'InvalidJwtTokenError';
+  }
+}

package/src/errors/invalid-model.ts

@@ -0,0 +1,11 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class InvalidModelError extends TranslatableSuiteError {
+  constructor(public readonly modelKey: string) {
+    super(SuiteCoreStringKey.Error_InvalidModelKeyTemplate, { modelKey });
+    this.name = 'InvalidModelError';
+  }
+}

package/src/errors/invalid-new-password.ts

@@ -0,0 +1,18 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteHandleableError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class InvalidNewPasswordError extends TranslatableSuiteHandleableError {
+  constructor(language?: string, statusCode = 422) {
+    super(
+      SuiteCoreStringKey.Validation_PasswordRegexErrorTemplate,
+      undefined,
+      language,
+      {
+        statusCode,
+      },
+    );
+    this.name = 'InvalidNewPasswordError';
+  }
+}

package/src/errors/invalid-password.ts

@@ -0,0 +1,13 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteHandleableError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class InvalidPasswordError extends TranslatableSuiteHandleableError {
+  constructor(language?: string, statusCode = 403) {
+    super(SuiteCoreStringKey.Validation_InvalidPassword, undefined, language, {
+      statusCode,
+    });
+    this.name = 'InvalidPasswordError';
+  }
+}

package/src/errors/missing-validated-data.ts

@@ -0,0 +1,36 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteHandleableError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class MissingValidatedDataError<
+  _TLanguage extends string,
+  _TContext extends string,
+> extends TranslatableSuiteHandleableError {
+  public readonly field?: string;
+  public readonly fields?: string[];
+  constructor(data?: string | string[]) {
+    let message: SuiteCoreStringKey;
+    let fields: string[] | undefined;
+    let field: string;
+    if (data && Array.isArray(data)) {
+      message =
+        SuiteCoreStringKey.Validation_MissingValidatedDataForFieldTemplate;
+      field = data.join(', ');
+      fields = data;
+    } else if (data) {
+      message =
+        SuiteCoreStringKey.Validation_MissingValidatedDataForFieldTemplate;
+      field = String(data);
+    } else {
+      message = SuiteCoreStringKey.Validation_MissingValidatedData;
+      field = '';
+    }
+    super(message, { field }, undefined, {
+      statusCode: 422,
+    });
+    this.field = field;
+    this.fields = fields;
+    this.name = 'MissingValidatedDataError';
+  }
+}

package/src/errors/mnemonic-or-password-required.ts

@@ -0,0 +1,13 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteHandleableError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class MnemonicOrPasswordRequiredError extends TranslatableSuiteHandleableError {
+  constructor() {
+    super(SuiteCoreStringKey.Validation_MnemonicOrPasswordRequired, {
+      statusCode: 422,
+    });
+    this.name = 'MnemonicOrPasswordRequiredError';
+  }
+}

package/src/errors/model-not-registered.ts

@@ -0,0 +1,11 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class ModelNotRegisteredError extends TranslatableSuiteError {
+  constructor(public readonly modelName: string) {
+    super(SuiteCoreStringKey.Error_ModelNotRegisteredTemplate, { modelName });
+    this.name = 'ModelNotRegisteredError';
+  }
+}

package/src/errors/mongoose-validation.ts

@@ -0,0 +1,38 @@
+import { CoreLanguageCode, HandleableError } from '@digitaldefiance/i18n-lib';
+import { Error } from '@digitaldefiance/mongoose-types';
+import {
+  getSuiteCoreI18nEngine,
+  SuiteCoreComponentId,
+  SuiteCoreStringKey,
+} from '@digitaldefiance/suite-core-lib';
+import { IApplication } from '../interfaces';
+
+export class MongooseValidationError extends HandleableError {
+  public readonly errors: {
+    [path: string]: Error.CastError | Error.ValidatorError;
+  };
+  constructor(
+    validationErrors: {
+      [path: string]: Error.CastError | Error.ValidatorError;
+    },
+    language?: CoreLanguageCode,
+    application?: IApplication,
+  ) {
+    const coreEngine = getSuiteCoreI18nEngine(
+      application ? { constants: application.constants } : undefined,
+    );
+    super(
+      new Error(
+        `${coreEngine.translate(
+          SuiteCoreComponentId,
+          SuiteCoreStringKey.Validation_MongooseValidationError,
+          undefined,
+          language,
+        )}: ${JSON.stringify(validationErrors)}`,
+      ),
+      { statusCode: 422 },
+    );
+    this.name = 'MongooseValidationError';
+    this.errors = validationErrors;
+  }
+}

package/src/errors/symmetric.ts

@@ -0,0 +1,37 @@
+import { CoreLanguageCode, PluginTypedError } from '@digitaldefiance/i18n-lib';
+import {
+  SuiteCoreComponentId,
+  SuiteCoreStringKey,
+} from '@digitaldefiance/suite-core-lib';
+import { LocalhostConstants } from '../constants';
+import { SymmetricErrorType } from '../enumerations/symmetric-error-type';
+import { IConstants } from '../interfaces/constants';
+import { SymmetricService } from '../services/symmetric';
+
+export class SymmetricError extends PluginTypedError<
+  typeof SymmetricErrorType,
+  SuiteCoreStringKey
+> {
+  constructor(
+    type: SymmetricErrorType,
+    language?: CoreLanguageCode,
+    constants: IConstants = LocalhostConstants,
+  ) {
+    super(
+      SuiteCoreComponentId,
+      type,
+      {
+        [SymmetricErrorType.DataNullOrUndefined]:
+          SuiteCoreStringKey.Error_SymmetricDataNullOrUndefined,
+        [SymmetricErrorType.InvalidKeyLength]:
+          SuiteCoreStringKey.Error_SymmetricInvalidKeyLengthTemplate,
+      },
+      language,
+      {
+        KEY_BITS: SymmetricService.symmetricKeyBits(constants.ECIES),
+        KEY_BYTES: SymmetricService.symmetricKeyBytes(constants.ECIES),
+      },
+    );
+    this.name = 'SymmetricError';
+  }
+}

package/src/errors/token-expired.ts

@@ -0,0 +1,11 @@
+import {
+  SuiteCoreStringKey,
+  TranslatableSuiteError,
+} from '@digitaldefiance/suite-core-lib';
+
+export class TokenExpiredError extends TranslatableSuiteError {
+  constructor() {
+    super(SuiteCoreStringKey.Validation_TokenExpired, { statusCode: 401 });
+    this.name = 'TokenExpiredError';
+  }
+}

package/src/get-language.ts

@@ -0,0 +1,53 @@
+import {
+  GlobalActiveContext,
+  IActiveContext,
+  LanguageRegistry,
+} from '@digitaldefiance/i18n-lib';
+import {
+  getSuiteCoreTranslation,
+  SuiteCoreStringKey,
+} from '@digitaldefiance/suite-core-lib';
+import { debugLog } from './utils';
+
+export function setGlobalActiveContextAdminLanguageFromProcessArgvOrEnv(): string {
+  const consoleLanguageEnv = process.env['LANGUAGE'];
+  const consoleLanguageArgv = process.argv.find((arg) =>
+    arg.startsWith('--language='),
+  );
+
+  const context = GlobalActiveContext.getInstance<
+    string,
+    IActiveContext<string>
+  >();
+
+  // Prioritize command-line argument, then environment variable, then existing context
+  const rawLanguage =
+    (consoleLanguageArgv
+      ? consoleLanguageArgv.split('=')[1]
+      : consoleLanguageEnv) ?? context.adminLanguage;
+
+  if (!rawLanguage) {
+    return context.adminLanguage;
+  }
+
+  const consoleLanguage = rawLanguage.replace(/^['"]|['"]$/g, '');
+
+  if (LanguageRegistry.hasLanguage(consoleLanguage)) {
+    context.setAdminLanguage(consoleLanguage as string);
+    return context.adminLanguage;
+  }
+
+  // If the language is invalid, log a warning and return the unchanged (default) language
+  debugLog(
+    true,
+    'error',
+    getSuiteCoreTranslation(
+      SuiteCoreStringKey.Error_InvalidLanguageCodeTemplate,
+      {
+        LANGUAGE: consoleLanguage,
+        DEFAULT_LANGUAGE: context.adminLanguage,
+      },
+    ),
+  );
+  return context.adminLanguage;
+}

package/src/get-timezone.ts

@@ -0,0 +1,61 @@
+import type { Timezone as TimezoneType } from '@digitaldefiance/i18n-lib';
+import {
+  GlobalActiveContext,
+  IActiveContext,
+  isValidTimezone,
+} from '@digitaldefiance/i18n-lib';
+import { existsSync, readFileSync } from 'fs';
+
+// Type for Timezone constructor
+type TimezoneConstructor = new (tz: string) => TimezoneType;
+
+// Helper to create Timezone from the same module instance as GlobalActiveContext
+function createTimezone(tz: string): TimezoneType {
+  const context = GlobalActiveContext.getInstance<
+    string,
+    IActiveContext<string>
+  >();
+  // Get the Timezone constructor from the existing timezone object
+  const TimezoneConstructor = context.adminTimezone
+    .constructor as TimezoneConstructor;
+  return new TimezoneConstructor(tz);
+}
+
+export function setGlobalActiveContextAdminTimezoneFromProcessArgvOrEnv(): string {
+  const systemTz = existsSync('/etc/timezone')
+    ? readFileSync('/etc/timezone', 'utf8').trim()
+    : undefined;
+  const consoleTimezoneEnv = process.env['TZ'];
+  const consoleTimezoneArgv = process.argv.find((arg) =>
+    arg.startsWith('--timezone='),
+  );
+
+  // Prioritize command-line argument, then environment variable, then /etc/timezone
+  // if command-line argument is set, and is valid (isValidTimezone), use that
+  // if TZ env is set, and is valid (isValidTimezone), use that
+  // if /etc/timezone has a timezone, and is valid (isValidTimezone) use that
+  const validSystemTz =
+    systemTz && isValidTimezone(systemTz) ? systemTz : undefined;
+  const validConsoleTimezoneEnv =
+    consoleTimezoneEnv && isValidTimezone(consoleTimezoneEnv)
+      ? consoleTimezoneEnv
+      : undefined;
+  const argValue = consoleTimezoneArgv?.split('=')[1];
+  const validConsoleTimezoneArgv =
+    argValue && isValidTimezone(argValue) ? argValue : undefined;
+
+  const context = GlobalActiveContext.getInstance<
+    string,
+    IActiveContext<string>
+  >();
+
+  const timezoneStr =
+    validConsoleTimezoneArgv ??
+    validConsoleTimezoneEnv ??
+    validSystemTz ??
+    context.adminTimezone.value;
+
+  const finalTimezone = timezoneStr ?? 'UTC';
+  context.adminTimezone = createTimezone(finalTimezone);
+  return finalTimezone;
+}

package/src/{index.d.ts → index.ts}

@@ -1,4 +1,6 @@
 import 'reflect-metadata';
+import './types.d';
+
 export * from './application';
 export * from './application-base';
 export * from './application-concrete';
@@ -6,9 +8,8 @@ export * from './backup-code';
 export * from './builders';
 export * from './constants';
 export * from './container';
-export * from './database';
 export * from './controllers';
-export * from './container';
+export * from './database';
 export * from './decorators';
 export * from './defaults';
 export * from './documents';
@@ -35,4 +36,3 @@ export * from './types';
 export { withTransaction } from './utils';
 export type { TransactionOptions as UtilsTransactionOptions } from './utils';
 export * from './validation';
-//# sourceMappingURL=index.d.ts.map

package/src/interfaces/{api-error-response.d.ts → api-error-response.ts}

@@ -1,5 +1,5 @@
 import { IApiMessageResponse } from './api-message-response';
+
 export interface IApiErrorResponse extends IApiMessageResponse {
-    error: unknown;
+  error: unknown;
 }
-//# sourceMappingURL=api-error-response.d.ts.map

package/src/interfaces/api-express-validation-error-response.ts

@@ -0,0 +1,8 @@
+import { Result, ValidationError } from 'express-validator';
+import { IApiMessageResponse } from './api-message-response';
+
+export interface IApiExpressValidationErrorResponse
+  extends IApiMessageResponse {
+  errors: ValidationError[] | Result<ValidationError>;
+  errorType?: string;
+}

package/src/interfaces/api-message-response.ts

@@ -0,0 +1,3 @@
+export interface IApiMessageResponse {
+  message: string;
+}

package/src/interfaces/{api-mongo-validation-error-response.d.ts → api-mongo-validation-error-response.ts}

@@ -1,6 +1,6 @@
 import { IApiMessageResponse } from './api-message-response';
 import { IMongoErrors } from './mongo-errors';
+
 export interface IApiMongoValidationErrorResponse extends IApiMessageResponse {
-    errors: IMongoErrors;
+  errors: IMongoErrors;
 }
-//# sourceMappingURL=api-mongo-validation-error-response.d.ts.map

package/src/interfaces/api-responses/{backup-codes-response.d.ts → backup-codes-response.ts}

@@ -1,5 +1,5 @@
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiBackupCodesResponse extends IApiMessageResponse {
-    backupCodes: Array<string>;
+  backupCodes: Array<string>;
 }
-//# sourceMappingURL=backup-codes-response.d.ts.map

package/src/interfaces/api-responses/{challenge-response.d.ts → challenge-response.ts}

@@ -1,6 +1,6 @@
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiChallengeResponse extends IApiMessageResponse {
-    challenge: string;
-    serverPublicKey: string;
+  challenge: string;
+  serverPublicKey: string;
 }
-//# sourceMappingURL=challenge-response.d.ts.map

package/src/interfaces/api-responses/{code-count-response.d.ts → code-count-response.ts}

@@ -1,5 +1,5 @@
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiCodeCountResponse extends IApiMessageResponse {
-    codeCount: number;
+  codeCount: number;
 }
-//# sourceMappingURL=code-count-response.d.ts.map

package/src/interfaces/api-responses/{index.d.ts → index.ts}

@@ -6,4 +6,3 @@ export * from './mnemonic-response';
 export * from './registration-response';
 export * from './request-user-response';
 export * from './user-settings-response';
-//# sourceMappingURL=index.d.ts.map

package/src/interfaces/api-responses/{login-response.d.ts → login-response.ts}

@@ -1,8 +1,8 @@
 import { IRequestUserDTO } from '@digitaldefiance/suite-core-lib';
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiLoginResponse extends IApiMessageResponse {
-    user: IRequestUserDTO;
-    token: string;
-    serverPublicKey: string;
+  user: IRequestUserDTO;
+  token: string;
+  serverPublicKey: string;
 }
-//# sourceMappingURL=login-response.d.ts.map

package/src/interfaces/api-responses/{mnemonic-response.d.ts → mnemonic-response.ts}

@@ -1,5 +1,5 @@
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiMnemonicResponse extends IApiMessageResponse {
-    mnemonic: string;
+  mnemonic: string;
 }
-//# sourceMappingURL=mnemonic-response.d.ts.map

package/src/interfaces/api-responses/{registration-response.d.ts → registration-response.ts}

@@ -1,6 +1,6 @@
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiRegistrationResponse extends IApiMessageResponse {
-    mnemonic: string;
-    backupCodes: Array<string>;
+  mnemonic: string;
+  backupCodes: Array<string>;
 }
-//# sourceMappingURL=registration-response.d.ts.map

package/src/interfaces/api-responses/{request-user-response.d.ts → request-user-response.ts}

@@ -1,6 +1,6 @@
 import { IRequestUserDTO } from '@digitaldefiance/suite-core-lib';
 import { IApiMessageResponse } from '../api-message-response';
+
 export interface IApiRequestUserResponse extends IApiMessageResponse {
-    user: IRequestUserDTO;
+  user: IRequestUserDTO;
 }
-//# sourceMappingURL=request-user-response.d.ts.map

package/src/interfaces/api-responses/user-settings-response.ts

@@ -0,0 +1,12 @@
+import { IApiMessageResponse } from '../api-message-response';
+
+export interface IApiUserSettingsResponse extends IApiMessageResponse {
+  settings: {
+    email: string;
+    timezone: string;
+    currency: string;
+    siteLanguage: string;
+    darkMode: boolean;
+    directChallenge: boolean;
+  };
+}

package/src/interfaces/application.ts

@@ -0,0 +1,16 @@
+import mongoose, { Model } from '@digitaldefiance/mongoose-types';
+import { ServiceContainer } from '../container';
+import { IBaseDocument } from '../documents';
+import { Environment } from '../environment';
+import { IConstants } from './constants';
+
+export interface IApplication {
+  get environment(): Environment;
+  get constants(): IConstants;
+  get db(): typeof mongoose;
+  get ready(): boolean;
+  get services(): ServiceContainer;
+  get plugins(): import('../plugins').PluginManager;
+  start(): Promise<void>;
+  getModel<U extends IBaseDocument<any, any>>(modelName: string): Model<U>;
+}

package/src/interfaces/backend-objects/email-token.ts

@@ -0,0 +1,9 @@
+import { Types } from '@digitaldefiance/mongoose-types';
+import {
+  EmailTokenType,
+  IEmailTokenBase,
+} from '@digitaldefiance/suite-core-lib';
+
+export type IEmailTokenBackendObject<
+  I extends string | Types.ObjectId = Types.ObjectId,
+> = IEmailTokenBase<I, Date, EmailTokenType>;

package/src/interfaces/backend-objects/{index.d.ts → index.ts}

@@ -2,4 +2,3 @@ export * from './email-token';
 export * from './request-user';
 export * from './role';
 export * from './user';
-//# sourceMappingURL=index.d.ts.map

package/src/interfaces/backend-objects/request-user.ts

@@ -0,0 +1,8 @@
+import { Types } from '@digitaldefiance/mongoose-types';
+import { IRequestUser } from '../request-user';
+import { IRoleBackendObject } from './role';
+
+export type IRequestUserBackendObject<
+  S extends string,
+  I extends Types.ObjectId | string = Types.ObjectId,
+> = IRequestUser<I, Array<IRoleBackendObject<any>>, S, Date>;

package/src/interfaces/backend-objects/role.ts

@@ -0,0 +1,6 @@
+import { Types } from '@digitaldefiance/mongoose-types';
+import { IRoleBase, Role } from '@digitaldefiance/suite-core-lib';
+
+export type IRoleBackendObject<
+  I extends string | Types.ObjectId = Types.ObjectId,
+> = IRoleBase<I, Date, Role>;

package/src/interfaces/backend-objects/user.ts

@@ -0,0 +1,7 @@
+import { Types } from '@digitaldefiance/mongoose-types';
+import { AccountStatus, IUserBase } from '@digitaldefiance/suite-core-lib';
+
+export type IUserBackendObject<
+  S extends string,
+  I = Types.ObjectId,
+> = IUserBase<I, Date, S, AccountStatus>;

package/src/interfaces/checksum-config.ts

@@ -0,0 +1,4 @@
+export interface IChecksumConfig {
+  algorithm: string;
+  encoding: 'hex' | 'base64';
+}

package/src/interfaces/checksum-consts.ts

@@ -0,0 +1,13 @@
+export interface IChecksumConsts {
+  /** Default hash bits for SHA3 */
+  SHA3_DEFAULT_HASH_BITS: number;
+
+  /** Length of a SHA3 checksum buffer in bytes */
+  SHA3_BUFFER_LENGTH: number;
+
+  /** Algorithm name for checksums */
+  ALGORITHM: string;
+
+  /** Encoding for checksums */
+  ENCODING: 'hex' | 'base64';
+}