@terreno/admin-spa 0.17.0

package/src/dist/serve.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminSpaServeApp = exports.injectBaseGlobal = exports.rewriteIndexHtml = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const api_1 = require("@terreno/api");
+const express_1 = __importDefault(require("express"));
+const appConfig_1 = require("./appConfig");
+// Compiled (CommonJS) file lives at src/dist/serve.js; the pre-built bundle lives at
+// admin-spa/dist. `__dirname` is the CommonJS module-directory global.
+const DIST_DIR = node_path_1.default.resolve(__dirname, "../../dist");
+const NO_STORE = "no-store";
+/**
+ * Rewrite the absolute `/_expo/` and `/assets/` references emitted by Expo's static
+ * web export so a single pre-built bundle works when mounted at any `basePath`.
+ */
+const rewriteIndexHtml = (rawIndex, basePath) => {
+    return rawIndex
+        .replaceAll('href="/_expo/', `href="${basePath}/_expo/`)
+        .replaceAll('src="/_expo/', `src="${basePath}/_expo/`)
+        .replaceAll('href="/assets/', `href="${basePath}/assets/`)
+        .replaceAll('src="/assets/', `src="${basePath}/assets/`);
+};
+exports.rewriteIndexHtml = rewriteIndexHtml;
+/**
+ * Inject `window.__ADMIN_SPA_BASE__` so the SPA can build absolute URLs (e.g.
+ * `${base}/app-config.json`) regardless of the current deep route. Inserted before
+ * `</head>` so it runs before the bundle.
+ */
+const injectBaseGlobal = (html, basePath) => {
+    const script = `<script>window.__ADMIN_SPA_BASE__=${JSON.stringify(basePath)};</script>`;
+    if (html.includes("</head>")) {
+        return html.replace("</head>", `${script}</head>`);
+    }
+    return script + html;
+};
+exports.injectBaseGlobal = injectBaseGlobal;
+/**
+ * Opt-in Express plugin that serves a pre-built admin SPA (Expo Router static export)
+ * from the same Node process as a Terreno backend. Mounts at `/console` by default.
+ *
+ * @example
+ * ```typescript
+ * new TerrenoApp({userModel: User})
+ *   .register(new BetterAuthApp({config, userModel: User}))
+ *   .register(new AdminApp({models: [...]}))
+ *   .register(new AdminSpaServeApp({basePath: "/console", appConfig: {brandName: "Acme"}}))
+ *   .start();
+ * ```
+ */
+class AdminSpaServeApp {
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    register(app) {
+        const basePath = this.opts.basePath ?? "/console";
+        const distDir = this.opts.distDir ?? DIST_DIR;
+        const appConfig = (0, appConfig_1.resolveAppConfig)(this.opts.appConfig);
+        // Dev proxy: forward SPA assets to `expo start --web`, but keep app-config on the plugin.
+        if (this.opts.devProxyTarget) {
+            // Register before the catch-all proxy so Express matches this route first.
+            app.get(`${basePath}/app-config.json`, (_req, res) => {
+                res.set("Cache-Control", NO_STORE).json(appConfig);
+            });
+            // Lazy require so production deploys without the dev dependency don't break.
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic require of optional dev dependency
+            const { createProxyMiddleware } = require("http-proxy-middleware");
+            app.use(basePath, createProxyMiddleware({
+                changeOrigin: true,
+                pathRewrite: { [`^${basePath}`]: "" },
+                target: this.opts.devProxyTarget,
+                ws: true,
+            }));
+            api_1.logger.info(`Admin SPA dev-proxied to ${this.opts.devProxyTarget} at ${basePath}/`);
+            return;
+        }
+        // Read index.html once and rewrite absolute asset refs to the mounted basePath.
+        const indexHtmlPath = node_path_1.default.join(distDir, "index.html");
+        let indexHtml = "";
+        try {
+            indexHtml = (0, exports.injectBaseGlobal)((0, exports.rewriteIndexHtml)(node_fs_1.default.readFileSync(indexHtmlPath, "utf-8"), basePath), basePath);
+        }
+        catch {
+            api_1.logger.warn(`Admin SPA: no pre-built bundle found at ${indexHtmlPath}. ` +
+                "Run `bun run --filter '@terreno/admin-spa' build:web` or set devProxyTarget.");
+        }
+        // 1. Hashed asset directories — long cache, immutable.
+        const staticOpts = { immutable: true, maxAge: "365d" };
+        app.use(`${basePath}/_expo`, express_1.default.static(node_path_1.default.join(distDir, "_expo"), staticOpts));
+        app.use(`${basePath}/assets`, express_1.default.static(node_path_1.default.join(distDir, "assets"), staticOpts));
+        // 2. Runtime config — never cached.
+        app.get(`${basePath}/app-config.json`, (_req, res) => {
+            res.set("Cache-Control", NO_STORE).json(appConfig);
+        });
+        // 3. SPA fallback. Two registrations: bare basePath (no trailing slash) AND splat,
+        // matching the `/*name` Express 5 convention used elsewhere in the repo.
+        const serveSpa = (_req, res) => {
+            res.set("Cache-Control", NO_STORE).type("html").send(indexHtml);
+        };
+        app.get(basePath, serveSpa);
+        app.get(`${basePath}/*splat`, serveSpa);
+        api_1.logger.info(`Admin SPA mounted at ${basePath}/`);
+    }
+}
+exports.AdminSpaServeApp = AdminSpaServeApp;