Expose server version via /version endpoint

Author: pimterry

.github/workflows/ci.yml

@@ -65,7 +65,7 @@ jobs:
           platforms: linux/amd64,linux/arm64
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
-          build-args: VERSION=${{ github.sha }}
+          build-args: GIT_HASH=${{ github.sha }}
 
       - name: Extract sha-* image label
         id: extract-sha

Dockerfile

@@ -11,4 +11,6 @@ RUN npm ci --omit=dev
 
 COPY src/ src/
 
+ARG GIT_HASH
+ENV VERSION_HASH=${GIT_HASH}
 CMD ["npm", "start"]

src/endpoints/http-index.ts

@@ -35,4 +35,5 @@ export * from './http/json.js';
 export * from './http/trailers.js';
 export * from './http/error/close.js';
 export * from './http/error/reset.js';
-export * from './http/example-page.js';
+export * from './http/example-page.js';
+export * from './http/version.js';

src/endpoints/http/version.ts

@@ -0,0 +1,17 @@
+import { HttpEndpoint, HttpHandler } from '../http-index.js';
+
+const versionHash = process.env.VERSION_HASH || 'unknown';
+
+const matchPath = (path: string) => path === '/version';
+
+const handle: HttpHandler = (_req, res) => {
+    res.writeHead(200, { 'content-type': 'application/json' });
+    res.end(JSON.stringify({
+        versionHash
+    }));
+}
+
+export const versionJson: HttpEndpoint = {
+    matchPath,
+    handle
+};