Merge branch 'master' into port-colision

apps/server/src/app.ts

@@ -6,11 +6,11 @@ import expressStaticGzip from 'express-static-gzip';
 import http, { Server } from 'http';
 import cors from 'cors';
 import serverTiming from 'server-timing';
+import { extname, resolve } from 'path';
 
 // import utils
-import { resolve } from 'path';
 import { publicDir, srcDir } from './setup/index.js';
-import { environment, isProduction } from './externals.js';
+import { environment, isProduction, updateRouterPrefix } from './externals.js';
 import { ONTIME_VERSION } from './ONTIME_VERSION.js';
 import { consoleSuccess, consoleHighlight, consoleError } from './utils/console.js';
 
@@ -53,9 +53,12 @@ if (!canLog) {
   console.log(`Ontime public directory at ${publicDir.root} `);
 }
 
+// calls an update to the client router prefix
+updateRouterPrefix();
+
 // Create express APP
 const app = express();
-if (process.env.NODE_ENV === 'development') {
+if (!isProduction) {
   // log server timings to requests
   app.use(serverTiming());
 }
@@ -89,10 +92,22 @@ app.use(
   expressStaticGzip(srcDir.clientDir, {
     enableBrotli: true,
     orderPreference: ['br'],
-    // when we build the client all the react subfiles will get a hashed name we can the immutable tag
+    // when we build the client the file names contain a unique hash for the build
+    // this allows us to use the immutable tag
     // as the contents of a build file will never change without also changing its name
-    // so the client dose not need to revalidate the file contetnts with the server
-    serveStatic: { etag: false, lastModified: false, immutable: true, maxAge: '1y' },
+    // meaning that the client does not need to revalidate the contents with the server
+    serveStatic: {
+      etag: false,
+      lastModified: false,
+      immutable: true,
+      maxAge: '1y',
+      setHeaders: (res, file) => {
+        // make sure the HTML files are always revalidated
+        if (extname(file) === '.html') {
+          res.setHeader('Cache-Control', 'public, max-age=0');
+        }
+      },
+    },
   }),
 );
 

apps/server/src/externals.ts

@@ -2,6 +2,9 @@
  * This file contains a list of constants that may need to be resolved at runtime
  */
 
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
 // =================================================
 // resolve running environment
 const env = process.env.NODE_ENV || 'production';
@@ -10,3 +13,25 @@ export const isTest = Boolean(process.env.IS_TEST);
 export const environment = isTest ? 'test' : env;
 export const isDocker = env === 'docker';
 export const isProduction = isDocker || (env === 'production' && !isTest);
+
+/**
+ * Updates the router prefix in the index.html file
+ * This is only needed in the cloud environment where the client is not at the root segment
+ * ie: https://cloud.getontime.com/client-hash/timer
+ */
+export function updateRouterPrefix(prefix: string | undefined = process.env.ROUTER_PREFIX) {
+  if (!prefix) {
+    return;
+  }
+
+  const indexFile = resolve('.', 'client', 'index.html');
+  try {
+    const data = readFileSync(indexFile, { encoding: 'utf-8', flag: 'r' }).replace(
+      /<base href="[^"]*">/g,
+      `<base href="${prefix}>"`,
+    );
+    writeFileSync(indexFile, data, { encoding: 'utf-8', flag: 'w' });
+  } catch (_error) {
+    /** unhandled */
+  }
+}