npm - @digitaldefiance/express-suite-starter - Versions diffs - 4.19.11 → 4.21.0 - Mend

@digitaldefiance/express-suite-starter 4.19.11 → 4.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (107) hide show

package/scaffolding/api-lib-mern/src/lib/middlewares.ts.mustache ADDED Viewed

@@ -0,0 +1,113 @@
+import { AppConstants } from '{{namespace}}/lib';
+import cors from 'cors';
+import { randomBytes } from 'crypto';
+import {
+  Application,
+  json,
+  NextFunction,
+  Request,
+  Response,
+  urlencoded,
+} from 'express';
+import helmet from 'helmet';
+import { IncomingMessage, ServerResponse } from 'http';
+  /**
+   * CORS whitelist
+   */
+  const corsWhitelist = [
+    /^https?:\/\/localhost:(3000|3443|4200)$/,
+    new RegExp(
+      `^https?:\\/\\/${AppConstants.SiteHostname.replace(
+        /[.*+?^${}()|[\]\\]/g,
+        '\\$&'
+      )}$`
+    ),
+  ];
+  /**
+   * CORS options delegate
+   * @param req - CORS request
+   * @param callback - Callback function
+   */
+  const corsOptionsDelegate = (
+    req: cors.CorsRequest,
+    callback: (
+      error: Error | null,
+      options: cors.CorsOptions | undefined,
+    ) => void,
+  ) => {
+    let corsOptions: cors.CorsOptions;
+    const origin = req.headers.origin;
+    if (
+      origin &&
+      corsWhitelist.find((w) => {
+        if (w instanceof RegExp) {
+          return w.test(origin);
+        } else {
+          return w === origin;
+        }
+      })
+    ) {
+      corsOptions = { origin: true };
+    } else {
+      corsOptions = { origin: false };
+    }
+    callback(null, corsOptions);
+  };
+  /**
+   * Initialize the middleware
+   * @param app - Express application
+   */
+export const initMiddleware = (app: Application): void => {
+  // Helmet helps you secure your Express apps by setting various HTTP headers
+  // CSP nonce
+  app.use((req: Request, res: Response, next: NextFunction) => {
+    res.locals['cspNonce'] = randomBytes(32).toString('hex');
+    next();
+  });
+  app.use(
+    helmet({
+      contentSecurityPolicy: {
+        directives: {
+          defaultSrc: ["'self'"],
+          imgSrc: ["'self'", 'https://flagcdn.com', 'data:', 'blob:'],
+          connectSrc: [
+            "'self'",
+            'http://localhost:3000',
+            'https://localhost:3000',
+            'http://localhost:4200',
+            'https://localhost:4200',
+            'https://localhost:3443',
+            `http://${AppConstants.SiteHostname}`,
+            `https://${AppConstants.SiteHostname}`,
+          ],
+          scriptSrc: [
+            "'self'",
+            //"'unsafe-inline'",
+            "'strict-dynamic'",
+            (req: IncomingMessage, res: ServerResponse) =>
+              `'nonce-${(res as Response).locals['cspNonce']}'`,
+          ],
+          styleSrc: [
+            "'self'",
+            "'unsafe-inline'",
+            'https://fonts.googleapis.com',
+          ],
+          fontSrc: [
+            "'self'",
+            'https://fonts.gstatic.com',
+          ],
+          frameSrc: ["'self'"],
+        },
+      },
+    }),
+  );
+  // Enable CORS
+  app.use(cors(corsOptionsDelegate));
+  // Parse incoming requests with JSON payloads
+  app.use(json());
+  // Parse incoming requests with urlencoded payloads
+  app.use(urlencoded({ extended: true }));
+}

package/scaffolding/api-lib-mern/src/lib/services/index.ts ADDED Viewed

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

package/scaffolding/{api → api-mern}/.env.example.mustache RENAMED Viewed

@@ -16,6 +16,7 @@ API_DIST_DIR=/workspaces/{{workspaceName}}/dist/{{prefix}}-api
 REACT_DIST_DIR=/workspaces/{{workspaceName}}/dist/{{prefix}}-react
 DEBUG=true
 DETAILED_DEBUG=true
+EMAIL_DOMAIN=example.com
 # Admin and test credentials
 ADMIN_ID=""
 ADMIN_MNEMONIC=""

package/scaffolding/api-mern/src/assets/.gitkeep ADDED Viewed

File without changes

package/scaffolding/api-mern/src/views/index.ejs ADDED Viewed

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title><%= title %></title>
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" type="image/x-icon" href="/assets/favicon.ico" />
+    <script nonce="<%= cspNonce %>"></script>
+    <base href="<%= baseHref %>" />
+    <script nonce="<%= cspNonce %>">
+      window.APP_CONFIG = {
+        hostname: '<%= hostname %>',
+        siteTitle: '<%= title %>',
+        server: '<%= server %>',
+      };
+    </script>
+    <% if (cssFile) { %>
+    <link rel="stylesheet" href="<%= cssFile %>" />
+    <% } %>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100..900;1,100..900&display=swap"
+      rel="stylesheet"
+    />
+  </head>
+  <body>
+    <div id="root"></div>
+    <% if (jsFile) { %>
+    <script nonce="<%= cspNonce %>" type="module" src="<%= jsFile %>"></script>
+    <% } %>
+  </body>
+</html>

package/scaffolding/inituserdb-brightstack/.env.example.mustache ADDED Viewed

@@ -0,0 +1,14 @@
+BRIGHTCHAIN_BLOCKSTORE_PATH={{blockStorePath}}
+BRIGHTCHAIN_BLOCKSIZE_BYTES=1048576
+BRIGHTCHAIN_BLOCKSTORE_TYPE=disk
+USE_MEMORY_DOCSTORE={{useMemoryDocstore}}
+DEV_DATABASE={{devDatabase}}
+EMAIL_DOMAIN=example.com
+MEMBER_POOL_NAME=BrightChain
+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}}

package/scaffolding/inituserdb-brightstack/src/main.ts.mustache ADDED Viewed

@@ -0,0 +1,195 @@
+import {
+  brightchainDatabaseInit,
+  BrightDbApplication,
+  BrightDbEnvironment,
+} from '@brightchain/node-express-suite';
+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 { getSuiteCoreTranslation, SuiteCoreStringKey } from '@digitaldefiance/suite-core-lib';
+import { randomBytes } from 'crypto';
+import { join } from 'path';
+import { rm } from 'fs/promises';
+// Simple debugLog implementation
+function debugLog(debug: boolean, type: 'log' | 'warn' | 'error', ...args: any[]): void {
+  if (debug) {
+    console[type](...args);
+  }
+}
+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(
+    BrightDbApplication.distDir,
+    '{{prefix}}-inituserdb',
+    '.env',
+  );
+  const env = new BrightDbEnvironment(envDir, true);
+  const shouldDrop = process.argv.includes('--drop');
+  // If --drop is requested, clear the block store path directory
+  if (shouldDrop && env.blockStorePath) {
+    debugLog(
+      env.detailedDebug,
+      'log',
+      `Clearing block store directory: ${env.blockStorePath}`,
+    );
+    try {
+      await rm(env.blockStorePath, { recursive: true, force: true });
+      debugLog(
+        env.detailedDebug,
+        'log',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_DatabaseDropped),
+      );
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      debugLog(
+        env.detailedDebug,
+        'log',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_ProceedingToDbInitialization),
+      );
+    } catch (err) {
+      debugLog(
+        env.detailedDebug,
+        'error',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_Error_FailedToDropDatabase),
+        err,
+      );
+      process.exit(2);
+    }
+  } else if (shouldDrop && !env.blockStorePath) {
+    debugLog(
+      env.detailedDebug,
+      'log',
+      'In-memory mode: --drop is a no-op (data is ephemeral)',
+    );
+  }
+  debugLog(
+    env.detailedDebug,
+    'log',
+    getSuiteCoreTranslation(SuiteCoreStringKey.Admin_StartingDbInitialization),
+  );
+  let exitCode = 1;
+  const result = await brightchainDatabaseInit(env);
+  if (result.success && result.backend) {
+    debugLog(
+      env.debug,
+      'log',
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_UserDatabaseInitialized,
+      ),
+    );
+    if (env.detailedDebug) {
+      console.log('Block store initialized successfully');
+      console.log(`  Block store type: ${env.blockStoreType}`);
+      if (env.blockStorePath) {
+        console.log(`  Block store path: ${env.blockStorePath}`);
+      }
+      console.log(`  Member pool name: ${env.memberPoolName}`);
+    }
+    // Handle --setEnv flag to write credentials to .env file
+    if (process.argv.includes('--setEnv')) {
+      const apiEnvPath = join(
+        BrightDbApplication.distDir,
+        '..', // Go up from dist
+        '{{prefix}}-api',
+        '.env',
+      );
+      debugLog(
+        env.detailedDebug,
+        'log',
+        `Writing environment to: ${apiEnvPath}`,
+      );
+    }
+    // Disconnect the BrightDb instance
+    if (result.backend.db) {
+      await result.backend.db.disconnect();
+    }
+    exitCode = 0;
+  } else {
+    console.error(
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabase,
+      ),
+      result.error,
+    );
+    exitCode++;
+  }
+  process.exit(exitCode);
+}
+main().catch((err) => {
+  console.error(
+    getSuiteCoreTranslation(
+      SuiteCoreStringKey.Admin_Error_UnhandledErrorInMain,
+    ),
+    err,
+  );
+  process.exit(1);
+});

package/scaffolding/{inituserdb → inituserdb-mern}/.env.example.mustache RENAMED Viewed

@@ -4,6 +4,7 @@ API_DIST_DIR=/workspaces/{{workspaceName}}/dist/{{prefix}}-api
 REACT_DIST_DIR=/workspaces/{{workspaceName}}/dist/{{prefix}}-react
 DEBUG=true
 DETAILED_DEBUG=true
+EMAIL_DOMAIN=example.com
 MNEMONIC_ENCRYPTION_KEY={{mnemonicEncryptionKey}}
 MNEMONIC_HMAC_SECRET={{mnemonicHmacSecret}}
 MONGO_USE_TRANSACTIONS=false

/package/scaffolding/{api → api-brightstack}/src/assets/.gitkeep RENAMED Viewed

File without changes

/package/scaffolding/{api → api-brightstack}/src/views/index.ejs RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/constants.ts.mustache RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/documents/index.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/interfaces/constants.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/interfaces/environment-aws.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/interfaces/environment.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/middlewares.ts.mustache RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-brightstack}/src/lib/services/index.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/index.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/application.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/documents/user.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/environment.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/models/email-token.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/models/mnemonic.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/models/role.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/models/used-direct-login-token.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/models/user-role.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/models/user.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/routers/api.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/routers/app.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/routers/index.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/schemas/index.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/schemas/schema.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/schemas/user.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/services/email.ts RENAMED Viewed

File without changes

/package/scaffolding/{api-lib → api-lib-mern}/src/lib/shared-types.ts RENAMED Viewed

File without changes

/package/scaffolding/{api → api-mern}/src/main.ts.mustache RENAMED Viewed

File without changes

/package/scaffolding/{inituserdb → inituserdb-mern}/src/main.ts.mustache RENAMED Viewed

File without changes