build: update paltform and implement env.config

env.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  FALSE_VALUE: false,
+  CORRECT_BOOL_VALUE: 'Good, false meant false.  We did not cast a boolean to a string.',
+  INCORRECT_BOOL_VALUE: 'Why was a false boolean true?',
+  INTEGER_VALUE: 123,
+};

fallback.env.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  // DO NOT PUT ANY CONFIGURATION IN THIS FILE.
+
+  // The existence of this file is a technical detail of the mechanism used to implement
+  // env.config.js files for jest.
+
+  // This file is used as a fallback to prevent build errors if an env.config.js file has not been
+  // defined in a consuming application.  If we could inline an empty object instead of needing a
+  // file to reference, that'd be clearer, but doesn't seem to be an option.
+
+  // This is NOT an appropriate place to put actual configuration values for tests.
+};

gatsby-config.js

@@ -3,6 +3,7 @@
 // eg.
 // $ ACTIVE_ENV=<env_name> npm run build
 const activeEnv = process.env.ACTIVE_ENV || process.env.NODE_ENV || 'development';
+const path = require('path');
 
 require('dotenv').config({
   path: `.env.${activeEnv}`,
@@ -19,6 +20,20 @@ if (process.env.UNBRANDED_LANDING_PAGE === 'True') {
 module.exports = {
   pathPrefix: `${process.env.ENABLE_PATH_PREFIX ? process.env.HOSTNAME : '/'}`,
   plugins: [
+    {
+      resolve: 'gatsby-plugin-alias-imports',
+      options: {
+        alias: {
+          'env.config': path.join(__dirname, './env.config.js'),
+        },
+        fallback: {
+          // This causes the system to return an empty object if it can't find an env.config.js file in
+          // the application being built.
+          'env.config': false,
+        },
+        extensions: ['.js', '.jsx'],
+      },
+    },
     {
       resolve: '@edx/gatsby-source-portal-designer',
       options: {

jest.config.js

@@ -1,10 +1,20 @@
+const path = require('path');
+const fs = require('fs');
+
+let envConfigPath = path.join(__dirname, 'fallback.env.config.js');
+const appEnvConfigPath = path.join(__dirname, 'env.config.js');
+
+if (fs.existsSync(appEnvConfigPath)) {
+  envConfigPath = appEnvConfigPath;
+}
 module.exports = {
   transform: {
     '^.+\\.jsx?$': '<rootDir>/jest-preprocess.js',
   },
   moduleNameMapper: {
     '.+\\.(css|styl|less|sass|scss)$': 'identity-obj-proxy',
     '.+\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$': '<rootDir>/fileTransformer.js',
+    'env.config': envConfigPath,
   },
   testPathIgnorePatterns: ['node_modules', '.cache'],
   transformIgnorePatterns: ['node_modules/(?!(gatsby|@edx/paragon|@edx/frontend-platform|@edx/frontend-component-footer-edx))'],