aaexjs-test 1.0.0

package/dist/components/ClientOnly.d.ts

@@ -0,0 +1,6 @@
+interface ClientWrapperProps extends React.PropsWithChildren {
+    fallback?: React.ReactNode | React.ReactNode[];
+}
+export declare function ClientOnly({ children, fallback, }: ClientWrapperProps): import("react").ReactNode;
+export {};
+//# sourceMappingURL=ClientOnly.d.ts.map

package/dist/components/ClientOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../src/components/ClientOnly.tsx"],"names":[],"mappings":"AAEA,UAAU,kBAAmB,SAAQ,KAAK,CAAC,iBAAiB;IAC1D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;CAChD;AAED,wBAAiB,UAAU,CAAC,EAC1B,QAAQ,EACR,QAAe,GAChB,EAAE,kBAAkB,6BAWpB"}

package/dist/components/ClientOnly.js

@@ -0,0 +1,12 @@
+import { useEffect, useState } from "react";
+export function ClientOnly({ children, fallback = null, }) {
+    const [mounted, setMounted] = useState(false);
+    useEffect(() => {
+        setMounted(true);
+    }, []);
+    if (mounted) {
+        return children;
+    }
+    return fallback;
+}
+//# sourceMappingURL=ClientOnly.js.map

package/dist/components/ClientOnly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientOnly.js","sourceRoot":"","sources":["../../src/components/ClientOnly.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAM5C,MAAM,UAAW,UAAU,CAAC,EAC1B,QAAQ,EACR,QAAQ,GAAG,IAAI,GACI;IACnB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ClientOnly } from "./components/ClientOnly.js";
+export { pluginSsrDevFoucFix } from "./utils/ServerLoadCssImports.js";
+export * as Cookies from "./utils/cookies.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { ClientOnly } from "./components/ClientOnly.js";
+export { pluginSsrDevFoucFix } from "./utils/ServerLoadCssImports.js";
+export * as Cookies from "./utils/cookies.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/dist/utils/ServerLoadCssImports.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+export declare function pluginSsrDevFoucFix(): Plugin;
+//# sourceMappingURL=ServerLoadCssImports.d.ts.map

package/dist/utils/ServerLoadCssImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerLoadCssImports.d.ts","sourceRoot":"","sources":["../../src/utils/ServerLoadCssImports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAgB,MAAM,MAAM,CAAC;AAMhD,wBAAgB,mBAAmB,IAAI,MAAM,CA0C5C"}

package/dist/utils/ServerLoadCssImports.js

@@ -0,0 +1,45 @@
+//credit to https://github.com/vitejs/vite/issues/16515
+const virtualCssPath = '/@virtual:ssr-css.css';
+const collectedStyles = new Map();
+export function pluginSsrDevFoucFix() {
+    let server;
+    return {
+        name: 'ssr-dev-FOUC-fix',
+        apply: 'serve',
+        transform(code, id) {
+            if (id.includes('node_modules'))
+                return null;
+            if (id.includes('.css')) {
+                collectedStyles.set(id, code);
+            }
+            return null;
+        },
+        configureServer(server_) {
+            server = server_;
+            server.middlewares.use((req, _res, next) => {
+                if (req.url === virtualCssPath) {
+                    _res.setHeader('Content-Type', 'text/css');
+                    _res.write(Array.from(collectedStyles.values()).join('\n'));
+                    _res.end();
+                    return;
+                }
+                next();
+            });
+        },
+        transformIndexHtml: {
+            handler: async () => {
+                return [
+                    {
+                        tag: 'link',
+                        injectTo: 'head',
+                        attrs: {
+                            rel: 'stylesheet',
+                            href: virtualCssPath,
+                        },
+                    },
+                ];
+            },
+        },
+    };
+}
+//# sourceMappingURL=ServerLoadCssImports.js.map

package/dist/utils/ServerLoadCssImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerLoadCssImports.js","sourceRoot":"","sources":["../../src/utils/ServerLoadCssImports.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;AAElD,MAAM,UAAU,mBAAmB;IACjC,IAAI,MAAqB,CAAC;IAE1B,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,OAAO;QACd,SAAS,CAAC,IAAY,EAAE,EAAU;YAChC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7C,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,eAAe,CAAC,OAAO;YACrB,MAAM,GAAG,OAAO,CAAC;YAEjB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;gBACzC,IAAI,GAAG,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;oBAC/B,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;oBAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;oBACX,OAAO;gBACT,CAAC;gBACD,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;QACL,CAAC;QAED,kBAAkB,EAAE;YAClB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO;oBACL;wBACE,GAAG,EAAE,MAAM;wBACX,QAAQ,EAAE,MAAM;wBAChB,KAAK,EAAE;4BACL,GAAG,EAAE,YAAY;4BACjB,IAAI,EAAE,cAAc;yBACrB;qBACF;iBACF,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/cookies.d.ts

@@ -0,0 +1,13 @@
+export declare function setCookie(name: string, value: string, days?: number, options?: {
+    path?: string;
+    secure?: boolean;
+    sameSite?: "Strict" | "Lax" | "None";
+    domain?: string;
+}): void;
+export declare function getCookie(name: string): string | null;
+export declare function getCookieAsJSON(name: string): Record<string, string> | null | undefined;
+export declare function deleteCookie(name: string, options?: {
+    path?: string;
+    domain?: string;
+}): void;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/utils/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/utils/cookies.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,EACR,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,QAcP;AACD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,iBAWrC;AAiBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,6CAI3C;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,QAKjD"}

package/dist/utils/cookies.js

@@ -0,0 +1,47 @@
+export function setCookie(name, value, days = 7, options = {}) {
+    const maxAge = days * 24 * 60 * 60;
+    const encoded = encodeURIComponent(value);
+    let cookie = `${name}=${encoded}; max-age=${maxAge}; path=${options.path ?? "/"}`;
+    if (options.secure)
+        cookie += "; secure";
+    if (options.sameSite)
+        cookie += `; samesite=${options.sameSite}`;
+    if (options.domain)
+        cookie += `; domain=${options.domain}`;
+    document.cookie = cookie;
+}
+export function getCookie(name) {
+    const cookies = document.cookie.split("; ");
+    for (const c of cookies) {
+        const [key, ...rest] = c.split("=");
+        if (key === name) {
+            return decodeURIComponent(rest.join("="));
+        }
+    }
+    return null;
+}
+function cookieToJSON(cookie) {
+    const parts = cookie.split("; ");
+    const result = {};
+    for (const part of parts) {
+        const [key, ...rest] = part.split("=");
+        if (!key) {
+            return;
+        }
+        result[key] = rest.join("=");
+    }
+    return result;
+}
+export function getCookieAsJSON(name) {
+    const raw = getCookie(name);
+    if (!raw)
+        return null;
+    return cookieToJSON(raw);
+}
+export function deleteCookie(name, options = {}) {
+    let cookie = `${name}=; max-age=0; path=${options.path ?? "/"}`;
+    if (options.domain)
+        cookie += `; domain=${options.domain}`;
+    document.cookie = cookie;
+}
+//# sourceMappingURL=cookies.js.map

package/dist/utils/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/utils/cookies.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,KAAa,EACb,IAAI,GAAG,CAAC,EACR,UAKI,EAAE;IAEN,MAAM,MAAM,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,MAAM,GAAG,GAAG,IAAI,IAAI,OAAO,aAAa,MAAM,UAChD,OAAO,CAAC,IAAI,IAAI,GAClB,EAAE,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC;IACzC,IAAI,OAAO,CAAC,QAAQ;QAAE,MAAM,IAAI,cAAc,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC;IAE3D,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,UAA8C,EAAE;IAEhD,IAAI,MAAM,GAAG,GAAG,IAAI,sBAAsB,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC;IAC3D,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "aaexjs-test",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "npx tsc --watch",
+    "build": "tsc",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/react": "^19.2.7",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.0"
+  },
+  "dependencies": {
+    "react": "^19.2.3"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,103 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+/* ------------------------------
+   Paths & environment
+-------------------------------- */
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const projectRoot = process.cwd();
+const aaexDir = path.join(projectRoot, ".aaex");
+const templateDir = path.join(__dirname, "../templates/.aaex");
+const versionFile = path.join(aaexDir, "version.json");
+
+/* ------------------------------
+   Read framework version
+-------------------------------- */
+
+function readPackageVersion() {
+  try {
+    const pkgPath = path.join(__dirname, "../package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+}
+
+const frameworkVersion = readPackageVersion();
+
+/* ------------------------------
+   Helpers
+-------------------------------- */
+
+function readInstalledVersion() {
+  if (!fs.existsSync(versionFile)) return null;
+
+  try {
+    const json = JSON.parse(fs.readFileSync(versionFile, "utf-8"));
+    return json.version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+function writeVersionFile() {
+  const payload = {
+    framework: "aaexjs",
+    version: frameworkVersion,
+  };
+
+  fs.writeFileSync(versionFile, JSON.stringify(payload, null, 2));
+}
+
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/* ------------------------------
+   Main logic
+-------------------------------- */
+
+try {
+  const installedVersion = readInstalledVersion();
+
+  if (!fs.existsSync(aaexDir)) {
+    console.log("[aaexjs] Creating .aaex directory");
+    copyRecursive(templateDir, aaexDir);
+    writeVersionFile();
+    console.log(`[aaexjs] Installed framework files (v${frameworkVersion})`);
+    process.exit(1)
+  }
+
+  if (installedVersion !== frameworkVersion) {
+    console.log(
+      `[aaexjs] Updating .aaex from v${installedVersion ?? "unknown"} → v${frameworkVersion}`
+    );
+    copyRecursive(templateDir, aaexDir);
+    writeVersionFile();
+    console.log("[aaexjs] Update complete");
+  } else {
+    // Optional: keep silent to avoid noisy installs
+    // console.log("[aaexjs] .aaex is up to date");
+  }
+} catch (err) {
+  console.warn("[aaexjs] Failed to setup .aaex directory");
+  console.warn(err);
+}

package/templates/.aaex/BuildApiRoutes.js

@@ -0,0 +1,67 @@
+import { FileScanner } from "aaex-file-router/core";
+import { match } from "path-to-regexp";
+
+// --- scan folders ---
+//wrapper for the FilesScanner and output data
+async function scanApiFolder(folder) {
+  const scanner = new FileScanner(folder);
+  return await scanner.get_file_data();
+}
+
+const userApiFolder = "src/api";
+
+const internalApiFolder = ".aaex/api";
+
+//collect file data as easily parsed arrays
+const [userFiles, internalFiles] = await Promise.all([
+  scanApiFolder(userApiFolder),
+  scanApiFolder(internalApiFolder),
+]);
+
+// --- combine files ---
+const fileMap = new Map();
+internalFiles.forEach((f) => fileMap.set(f.relative_path, f));
+userFiles.forEach((f) => fileMap.set(f.relative_path, f)); //overrides internal api with user defined routes
+const combinedFiles = Array.from(fileMap.values());
+
+// --- build route list ---
+/**Builds route object from the scanned files */
+function buildApiRoutes(files) {
+  const routes = [];
+
+  function walk(node, currentPath) {
+    //recursivly iterate over child routes
+    if (node.isDirectory) {
+      node.children?.forEach((c) => walk(c, currentPath + "/" + node.name));
+      return;
+    }
+    const filePath = currentPath + "/" + node.name;
+    //build route path from filePath
+    let route = filePath
+      .replace(/^.*(src\/api|api)/, "/api") //removed parent folder like src
+      .replace(/\.ts|js$/, "") //removes file extension
+      .replace(/\[(.+?)\]/g, ":$1") //converts [slug] to :slug
+      .replace("/index", "");
+
+    routes.push({ route, filePath: node.relative_path });
+  }
+
+  files.forEach((file) => walk(file, ""));
+  return routes;
+}
+
+const routes = buildApiRoutes(combinedFiles);
+
+// --- match path to route ---
+/** Matches the given path to API routes generated from the api folder + the aaex/api folder*/
+function pathToRoute(pathname) {
+  for (const r of routes) {
+    const matcher = match(r.route, { decode: decodeURIComponent });
+    const matched = matcher(pathname);
+    if (matched) return { route: r, params: matched.params };
+  }
+  return null;
+}
+
+// --- export ---
+export { routes, pathToRoute };

package/templates/.aaex/api/auth/login.ts

@@ -0,0 +1,57 @@
+import { connectToDatabase } from "../../framework/database/mongodb";
+import type { Request, Response } from "express";
+import bcrypt from "bcrypt";
+import jwt from "jsonwebtoken";
+import { LoginUser } from "../../../src/models/User";
+
+export const POST = async (req: Request, res: Response) => {
+  const { email, password }: LoginUser = req.body;
+
+  if (!email || !password) {
+    return res.status(400).json({ error: "Missing fields!" });
+  }
+
+  const { db } = await connectToDatabase();
+
+  if (!process.env.JWT_SECRET) {
+    console.error("Missing: JWT_SECRET from environment variables");
+    return res
+      .status(500)
+      .json({ error: "Internal server error! Try again later" });
+  }
+
+  const normalizedEmail = email.trim().toLowerCase();
+  const user = await db.collection("users").findOne({ email: normalizedEmail });
+
+  if (!user) {
+    return res.status(400).json({ error: "Invalid email or password" });
+  }
+
+  const compared = await bcrypt.compare(password, user.password);
+
+  if (!compared) {
+    return res.status(400).json({ error: "Invalid email or password" });
+  }
+
+  const expiration = process.env.JWT_EXP ?? "24h";
+
+  const token = jwt.sign(
+    {
+      id: user._id.toString(),
+      email: user.email,
+      username: user.username,
+    },
+    process.env.JWT_SECRET as string,
+    { expiresIn: expiration as any } //fixes stupid thing where it wont accept the sring variable because its not number | ms.stringvlue | undefined
+  );
+
+  return res.status(200).json({
+    ok: true,
+    user: {
+      id: user._id.toString(),
+      name: user.username,
+      email: user.email,
+    },
+    token,
+  });
+};

package/templates/.aaex/api/auth/register.ts

@@ -0,0 +1,34 @@
+import { Request, Response } from "express";
+import bcrypt from "bcrypt";
+import { connectToDatabase } from "../../framework/database/mongodb";
+import { CreateUser } from "../../../src/models/User";
+export const POST = async (req: Request, res: Response) => {
+
+  const { email, username, password, confirmPass }: CreateUser = req.body;
+
+  if (!username || !email || !password || !confirmPass)
+    return res.status(400).json({ error: "Missing fields" });
+
+  if (password !== confirmPass)
+    return res.status(400).json({ error: "Passwords do not match" });
+
+  const { db } = await connectToDatabase();
+
+  const exists = await db.collection("users").findOne({ email });
+  if (exists)
+    return res
+      .status(409)
+      .json({ error: "User with that email already exists" });
+
+  const salt = 10;
+  const hashed = await bcrypt.hash(password, salt);
+
+  await db.collection("users").insertOne({
+    username,
+    email,
+    password: hashed,
+    createdAt: new Date(),
+  });
+
+  return res.status(201).json({ ok: true });
+};

package/templates/.aaex/api/auth/validate.ts

@@ -0,0 +1,18 @@
+import jwt from "jsonwebtoken";
+import type { Request, Response } from "express";
+
+export async function POST(req: Request, res: Response) {
+  const { token } = req.body;
+
+  if (!process.env.JWT_SECRET) {
+    console.error("Missing: JWT_SECRET from environment");
+    return res.status(500).json({error: "Internal server error!"});
+  }
+
+  try {
+    const decoded = jwt.verify(token, process.env.JWT_SECRET);
+    return res.status(200).json({ valid: true, user: decoded });
+  } catch (err) {
+    return res.status(401).json({ valid: false });
+  }
+}

package/templates/.aaex/framework/database/mongodb.ts

@@ -0,0 +1,29 @@
+import { MongoClient, Db } from "mongodb";
+
+const MONGO_URI = process.env.MONGO_URI || "mongodb://localhost:27017";
+const DB_NAME = process.env.DB_NAME || "mydatabase";
+
+if (!MONGO_URI) {
+  throw new Error("Please define the MONGO_URI environment variable inside .env");
+}
+
+let cachedClient: MongoClient | null = null;
+let cachedDb: Db | null = null;
+
+export async function connectToDatabase(): Promise<{ client: MongoClient; db: Db }> {
+  // Return cached connection if it exists
+  if (cachedClient && cachedDb) {
+    return { client: cachedClient, db: cachedDb };
+  }
+
+  const client = new MongoClient(MONGO_URI);
+  await client.connect();
+  const db = client.db(DB_NAME);
+
+  cachedClient = client;
+  cachedDb = db;
+
+  console.log("MongoDB connected:", DB_NAME);
+
+  return { client, db };
+}

package/templates/.aaex/framework/entry-client.tsx

@@ -0,0 +1,16 @@
+import "../../src/index.css";
+import { StrictMode } from "react";
+import { hydrateRoot } from "react-dom/client";
+import App from "../../src/App";
+import { BrowserRouter } from "react-router";
+
+const initialData = (window as any).__INITIAL_DATA__;
+
+hydrateRoot(
+  document.getElementById("root") as HTMLElement,
+  <StrictMode>
+    <BrowserRouter>
+      <App initialData={initialData} />
+    </BrowserRouter>
+  </StrictMode>
+);

package/templates/.aaex/framework/entry-server.tsx

@@ -0,0 +1,18 @@
+import { StrictMode, Suspense } from "react";
+import { renderToString } from "react-dom/server";
+import { StaticRouter } from "react-router";
+import App from "../../src/App";
+
+export function render(_url: string, initialData= {}) {
+  const url = `${_url}`;
+
+
+  const html = renderToString(
+    <StrictMode>
+      <StaticRouter location={url}>
+          <App initialData={initialData} />
+      </StaticRouter>
+    </StrictMode>
+  );
+  return { html };
+}

package/templates/.aaex/matchServerRoutes.js

@@ -0,0 +1,60 @@
+export default function routeMatcher(routes, url) {
+  const segments = url.split("/").filter(Boolean); // "test/hej" → ["test", "hej"]
+
+  return matchLevel(routes, segments);
+}
+
+function matchLevel(routes, segments) {
+  for (const route of routes) {
+    const result = matchRoute(route, segments);
+
+    if (result) return result;
+  }
+
+  return null;
+}
+
+function matchRoute(route, segments) {
+  const isParam = /^:[a-zA-Z0-9_]+$/;
+
+  const [current, ...rest] = segments;
+
+  // Root index route
+  if (route.path === "" && segments.length === 0) {
+    return { route, params: {} };
+  }
+
+  // Static match
+  if (route.path === current) {
+    if (rest.length === 0) {
+      return { route, params: {} };
+    }
+
+    // Has children → go deeper
+    if (route.children) {
+      return matchLevel(route.children, rest);
+    }
+  }
+
+  // Dynamic match → :slug , :id osv
+  if (isParam.test(route.path)) {
+    const paramName = route.path.slice(1);
+
+    if (rest.length === 0) {
+      return { route, params: { [paramName]: current } };
+    }
+
+    // Has children → go deeper
+    if (route.children) {
+      const matchedChild = matchLevel(route.children, rest);
+      if (matchedChild) {
+        return {
+          route: matchedChild.route,
+          params: { [paramName]: current, ...matchedChild.params },
+        };
+      }
+    }
+  }
+
+  return null;
+}

package/templates/.aaex/server/server.js

@@ -0,0 +1,179 @@
+import fs from "node:fs/promises";
+import express from "express";
+import { pathToFileURL } from "node:url";
+import path from "node:path";
+import dotenv from "dotenv";
+dotenv.config();
+
+// server.js is now in .aaex/server/
+const projectRoot = path.resolve("."); // root of the project
+let serverRoutes;
+// Import BuildApiRoutes
+import * as BuildApiRoutes from "../BuildApiRoutes.js";
+import routeMatcher from "../matchServerRoutes.js";
+
+const apiRoutes = BuildApiRoutes.default; // default export
+const PathToRoute = BuildApiRoutes.pathToRoute; // named export
+
+// Constants
+const isProduction = process.env.NODE_ENV === "production";
+const port = process.env.PORT || 5173;
+const base = process.env.BASE || "/";
+
+// Cached production HTML
+const templateHtml = isProduction
+  ? await fs.readFile(path.join(projectRoot, "dist/client/index.html"), "utf-8")
+  : "";
+
+// Create HTTP server
+const app = express();
+
+/** @type {import('vite').ViteDevServer | undefined} */
+let vite;
+if (!isProduction) {
+  const { createServer } = await import("vite");
+  vite = await createServer({
+    server: { middlewareMode: true },
+    appType: "custom",
+    root: projectRoot,
+    base,
+  });
+  serverRoutes = (await vite.ssrLoadModule("/src/server-routes.ts")).default;
+  app.use(vite.middlewares);
+} else {
+  const compression = (await import("compression")).default;
+  const sirv = (await import("sirv")).default;
+  app.use(compression());
+  app.use(
+    base,
+    sirv(path.join(projectRoot, "dist/client"), { extensions: [] })
+  );
+
+  const serverRoutesModule = await import(
+    pathToFileURL(path.join(projectRoot, "dist/src/server-routes.js")).href
+  );
+
+  serverRoutes = serverRoutesModule.default;
+}
+
+// parse JSON bodies
+app.use(express.json());
+
+// parse URL-encoded bodies (optional, for form POSTs)
+app.use(express.urlencoded({ extended: true }));
+
+// API routing
+app.use("/api", async (req, res) => {
+  const routeMatch = PathToRoute(req.path, apiRoutes);
+
+  if (!routeMatch)
+    return res.status(404).json({ error: "API route not found" });
+
+  const { route, params } = routeMatch;
+  let modulePath;
+
+  if (!isProduction) {
+    // DEV: Vite handles TS/JS loading
+    if (route.filePath.split("/")[0] == ".aaex") {
+      modulePath = `${route.filePath.replace(/^src\/api/, "")}`;
+    } else {
+      modulePath = `/src/api${route.filePath.replace(/^src\/api/, "")}`;
+    }
+  } else {
+    // PROD: bundled JS
+    modulePath = pathToFileURL(
+      `./dist/server/api${route.filePath
+        .replace(/^src\/api/, "")
+        .replace(/\.ts$/, ".js")}`
+    ).href;
+  }
+
+  try {
+    const mod = !isProduction
+      ? await vite.ssrLoadModule(modulePath)
+      : await import(modulePath);
+
+    const handler = mod[req.method]; // GET, POST, etc.
+
+    if (typeof handler !== "function") {
+      return res.status(405).json({ error: "Method not allowed" });
+    }
+
+    const result = await handler(req, res, params);
+
+    if (!res.headersSent) res.json(result);
+  } catch (err) {
+    console.error("API load error:", err);
+    res.status(500).json({ error: "Internal Server Error" });
+  }
+});
+
+// SSR HTML
+app.use(/.*/, async (req, res) => {
+  try {
+    let url = req.originalUrl;
+
+    const routeMatch = routeMatcher(serverRoutes, url);
+
+    if (!routeMatch) {
+      return res.status(404).send("Not found");
+    }
+
+    // Dynamicly import the file
+    const mod = await vite.ssrLoadModule(routeMatch.route.modulePath);
+
+    // Call load if it exist
+    let initialData = {};
+    if (mod.load) {
+      initialData = await mod.load(routeMatch.params);
+    }
+
+    let template;
+    let render;
+    if (!isProduction) {
+      template = await fs.readFile(
+        path.join(projectRoot, "index.html"),
+        "utf-8"
+      );
+      template = await vite.transformIndexHtml(url, template);
+      render = (await vite.ssrLoadModule("/.aaex/framework/entry-server.tsx"))
+        .render;
+    } else {
+      template = templateHtml;
+      render = (
+        await import(path.join(projectRoot, "dist/server/entry-server.js"))
+      ).render;
+    }
+
+    const rendered = await render(url, initialData);
+
+    function XSSPrevention(unsafeString) {
+      return unsafeString.replace(/</g, "//u003c");
+      // .replace(/>/g, "&gt")
+      // .replace(/'/g, "&#39")
+      // .replace(/"/g, "&#34");
+    }
+
+    const serializedData = JSON.stringify(initialData);
+    const safeData = XSSPrevention(serializedData);
+
+    const html = template
+      .replace("<!--app-head-->", rendered.head ?? "")
+      .replace("<!--app-html-->", rendered.html ?? "")
+      .replace(
+        "<!--initial-data-->",
+        `<script>window.__INITIAL_DATA__ = ${safeData}</script>`
+      );
+
+    res.status(200).set({ "Content-Type": "text/html" }).send(html);
+  } catch (e) {
+    vite?.ssrFixStacktrace?.(e);
+    console.error(e);
+    res.status(500).send(e.stack);
+  }
+});
+
+// Start server
+app.listen(port, () => {
+  console.log(`Server started at http://localhost:${port}`);
+});

package/templates/.aaex/version.json

@@ -0,0 +1,4 @@
+{
+  "framework": "aaexjs",
+  "version": "1.0.0"
+}