add tooling to check port and write config

Author: nicogarcia

.gitignore

@@ -44,4 +44,5 @@ Thumbs.db
 
 # Environment variables
 public/config.js
+.auth0.config.json
 

package-lock.json

@@ -3,10 +3,11 @@
   "version": "0.0.0",
   "scripts": {
     "ng": "ng",
-    "start": "ng serve",
+    "start": "node tools/check-port.cjs && node tools/serve.cjs",
     "build": "ng build",
     "watch": "ng build --watch --configuration development",
-    "test": "ng test"
+    "test": "ng test",
+    "auth0-config": "node tools/auth0-config.cjs"
   },
   "prettier": {
     "printWidth": 100,
@@ -37,6 +38,7 @@
     "@angular/build": "^21.0.3",
     "@angular/cli": "^21.0.3",
     "@angular/compiler-cli": "^21.0.0",
+    "detect-port": "^2.1.0",
     "jsdom": "^27.1.0",
     "typescript": "~5.9.2",
     "vitest": "^4.0.8"

package.json

@@ -0,0 +1,73 @@
+const fs = require("fs");
+const path = require("path");
+
+function parseArgs(args) {
+  const params = {};
+  for (let i = 2; i < args.length; i += 2) {
+    const key = args[i].replace("--", "");
+    const value = args[i + 1];
+    params[key] = value;
+  }
+  return params;
+}
+
+try {
+  const args = parseArgs(process.argv);
+
+  // Validate required arguments
+  if (!args.domain) {
+    console.error("Error: --domain argument is required");
+    console.error(
+      "Usage: node auth0-config.cjs --domain <domain> --clientId <clientId> [--port <port>]",
+    );
+    process.exit(1);
+  }
+
+  if (!args.clientId) {
+    console.error("Error: --clientId argument is required");
+    console.error(
+      "Usage: node auth0-config.cjs --domain <domain> --clientId <clientId> [--port <port>]",
+    );
+    process.exit(1);
+  }
+
+  // Validate port argument if provided
+  if (args.port) {
+    const portNumber = parseInt(args.port, 10);
+    if (isNaN(portNumber) || portNumber.toString() !== args.port.toString()) {
+      console.error("Error: --port argument must be a valid number");
+      console.error(
+        "Usage: node auth0-config.cjs --domain <domain> --clientId <clientId> [--port <port>]",
+      );
+      process.exit(1);
+    }
+  }
+
+  const port = args.port || "4200";
+
+  // Write public/config.js (browser config)
+  const configPath = path.join(__dirname, "..", "public", "config.js");
+  const configContent = `window.AUTH0_DOMAIN = '${args.domain}';
+window.AUTH0_CLIENT_ID = '${args.clientId}';
+`;
+  fs.writeFileSync(configPath, configContent);
+
+  // Write .auth0.config.json (server config - port only)
+  const auth0ConfigPath = path.join(__dirname, "..", ".auth0.config.json");
+  const auth0Config = {
+    port: parseInt(port, 10),
+  };
+  fs.writeFileSync(
+    auth0ConfigPath,
+    JSON.stringify(auth0Config, null, 2) + "\n",
+  );
+
+  console.log(`Auth0 configuration has been written`);
+  console.log("Config keys state:");
+  console.log(`  AUTH0_DOMAIN: ${args.domain}`);
+  console.log(`  AUTH0_CLIENT_ID: ${args.clientId}`);
+  console.log(`  PORT: ${port}`);
+} catch (e) {
+  console.error("Error:", e.message);
+  process.exit(1);
+}

tools/auth0-config.cjs

@@ -0,0 +1,43 @@
+const fs = require("fs");
+const path = require("path");
+const { detect } = require("detect-port");
+
+// Read .auth0.config.json to get the configured port
+const configPath = path.join(__dirname, "..", ".auth0.config.json");
+
+if (!fs.existsSync(configPath)) {
+  console.error(`
+❌ Configuration file not found: .auth0.config.json
+
+Please run the auth0-config script first:
+  npm run auth0-config -- --domain <domain> --clientId <clientId> --port <port>
+`);
+  process.exit(1);
+}
+
+const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+const PORT = config.port || 4200;
+
+detect(PORT)
+  .then((port) => {
+    if (port !== parseInt(PORT)) {
+      console.error(`
+❌ The port ${PORT} that is configured in Auth0 is currently in use.
+
+To resolve this issue:
+1. Free up port ${PORT} by stopping the application using it, OR
+2. Configure URLs with a new port in your Auth0 application settings:
+   - Allowed Callback URLs
+   - Allowed Logout URLs
+   - Allowed Web Origins
+   Then update the port by running:
+   npm run auth0-config -- --domain <domain> --clientId <clientId> --port <new-port>
+`);
+      process.exit(1);
+    }
+    console.log(`✅ Port ${PORT} is available.`);
+  })
+  .catch((err) => {
+    console.error("Error checking port availability:", err);
+    process.exit(1);
+  });

tools/check-port.cjs

@@ -0,0 +1,26 @@
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+// Read .auth0.config.json to get the configured port
+const configPath = path.join(__dirname, "..", ".auth0.config.json");
+
+if (!fs.existsSync(configPath)) {
+  console.error(`
+❌ Configuration file not found: .auth0.config.json
+
+Please run the auth0-config script first:
+  npm run auth0-config -- --domain <domain> --clientId <clientId> --port <port>
+`);
+  process.exit(1);
+}
+
+const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+const PORT = config.port || 4200;
+
+// Use npx to run local ng binary
+try {
+  execSync(`npx ng serve --port ${PORT}`, { stdio: "inherit" });
+} catch (err) {
+  process.exit(err.status || 1);
+}