maxserver 0.0.12 → 0.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "maxserver",
-	"version": "0.0.12",
+	"version": "0.0.14",
 	"description": "Node server setup based fastify",
 	"author": "Max Matinpalo",
 	"type": "module",

package/src/getAddress.js

@@ -1,29 +1,37 @@
-import os from "os";
-
+import os from "node:os";
 
 export function setupGetAddress(app) {
-	app.decorate("getAddress", function () {
-		const addr = this.server.address();
+	app.decorate("getAddress", () => {
+		const addr = app.server?.address();
+		const protocol = app.initialConfig?.https ? "https" : "http";
 
 		if (!addr) return null;
 		if (typeof addr === "string") return addr;
 
-		const protocol = this.initialConfig.https ? "https" : "http";
-		const host = getExternalIp() || "localhost";
+		const isPublicBind = addr.address === "0.0.0.0" || addr.address === "::";
+		const isLoopback = addr.address === "127.0.0.1" || addr.address === "::1";
+
+		const envIp = String(process.env.PUBLIC_IP || "").trim() || null;
+		const detectedIp = envIp || getLanIp();
+
+		const ip = (isPublicBind && !isLoopback)
+			? (detectedIp || addr.address)
+			: "localhost";
+
+		const host = ip.includes(":") ? `[${ip}]` : ip;
 
 		return `${protocol}://${host}:${addr.port}`;
 	});
 }
 
-
-function getExternalIp() {
+function getLanIp() {
 	const nets = os.networkInterfaces();
 
 	for (const name of Object.keys(nets)) {
-		for (const net of nets[name]) {
-			if (net.family === "IPv4" && !net.internal) return net.address;
+		for (const net of (nets[name] || [])) {
+			if (net?.family === "IPv4" && !net.internal) return net.address;
 		}
 	}
 
 	return null;
-}
+}

package/src/index.js

@@ -20,6 +20,7 @@ export default async function maxserver(options = {}) {
 
 	const app = Fastify({
 		trustProxy: true,
+		host: "0.0.0.0",
 		https: getHttpsOptions() || undefined,
 
 		// To allow writing example value fields to schemas for doucumentation 

package/templates/env

@@ -8,7 +8,7 @@ PORT = 3000
 # CORS_ORIGIN = https://app.example.com
 
 # JWT;
-JWT_SECRET = supersecretkey
+# JWT_SECRET = supersecretkey
 
 # MongoDB;
 # MONGODB_URI = mongodb://127.0.0.1:27017/testdb

package/templates/src/hello.js

@@ -1,8 +1,14 @@
-// GET /hello
+// POST /hello
 
 export default async function handler(req, rep) {
 
-	console.log("GET /hello");
+	console.log("POST /hello");
 
-	return { message: `Hello`, };
-}
+	return {
+		message: `Hello ${req.body.name} 🙋‍♂️`,
+	};
+}
+
+
+
+// Try POST with and without name, to see how the schema works

package/templates/src/{greet.schema.js → hello.schema.js}

@@ -1,6 +1,10 @@
-export const schema = {
+export default {
+
+	// These 3 fields are for the documentation
+	// Not must have, but your auto generated documentation will be great
+
 	tags: ["Test"],
-	summary: "Create greeting",
+	summary: "Post hello",
 	description: "Accepts a name and returns a greeting.",
 
 	body: {
@@ -22,13 +26,11 @@ export const schema = {
 					type: "string",
 					example: "Hello Max",
 				},
-				user: {
-					type: "object",
-					example: {
-						userId: "64f1c2e9b1a2c3d4e5f67890",
-					},
-				},
 			},
 		},
 	},
 };
+
+// Hint - You don't need to write these ourself
+// Just ask chat gpt or gemini to generate them
+// In docs you will find little instruction for it

package/templates/src/welcome.js

@@ -0,0 +1,14 @@
+// GET /welcome
+
+export default async function handler(req, rep) {
+
+	console.log("GET /welcome");
+	return {
+		message: "Weclome to maxserver 😉",
+	};
+
+}
+
+
+// Remember the very first line of the file must be the ROUTE COMMENT
+// other imports if needed after it

package/templates/src/greet.js

@@ -1,11 +0,0 @@
-// POST /hello
-
-export default async function handler(req, rep) {
-
-	console.log("POST /hello");
-
-	return {
-		message: `Hello ${req.body.name}`,
-		user: req.user || null,
-	};
-}