@epic-web/workshop-app 0.0.0-semantically-released

package/dist/server/index.js

@@ -0,0 +1,247 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { getPresentUsers } from "@epic-web/workshop-presence/presence.server";
+import {
+  getApps,
+  getWorkshopRoot,
+  init as initApps,
+  setModifiedTimesForAppDirs
+} from "@epic-web/workshop-utils/apps.server";
+import { checkForUpdatesCached } from "@epic-web/workshop-utils/git.server";
+import { checkConnectionCached } from "@epic-web/workshop-utils/utils.server";
+import { createRequestHandler } from "@react-router/express";
+import { ip as ipAddress } from "address";
+import chalk from "chalk";
+import chokidar from "chokidar";
+import closeWithGrace from "close-with-grace";
+import compression from "compression";
+import express from "express";
+import getPort, { portNumbers } from "get-port";
+import morgan from "morgan";
+import sourceMapSupport from "source-map-support";
+import { WebSocketServer } from "ws";
+const MODE = process.env.NODE_ENV ?? "development";
+void initApps();
+sourceMapSupport.install();
+const viteDevServer = process.env.NODE_ENV === "production" ? null : await import("vite").then(
+  (vite) => vite.createServer({
+    server: { middlewareMode: true },
+    appType: "custom"
+  })
+);
+const isProd = process.env.NODE_ENV === "production";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const isPublished = !fs.existsSync(path.join(__dirname, "..", "app"));
+const isDeployed = process.env.EPICSHOP_DEPLOYED === "true" || process.env.EPICSHOP_DEPLOYED === "1";
+const isRunningInBuildDir = path.dirname(__dirname).endsWith("dist");
+const epicshopAppRootDir = isRunningInBuildDir ? path.join(__dirname, "..", "..") : path.join(__dirname, "..");
+const hasUpdatesPromise = checkForUpdatesCached();
+void getApps();
+void checkConnectionCached();
+void getPresentUsers();
+const app = express();
+app.get(
+  "/.well-known/appspecific/com.chrome.devtools.json",
+  (req, res) => {
+    return res.status(404).send("Not found");
+  }
+);
+app.use(compression());
+app.disable("x-powered-by");
+app.use(
+  express.static(path.join(getWorkshopRoot(), "public"), {
+    maxAge: isProd ? "1h" : 0
+  })
+);
+if (viteDevServer) {
+  app.use(viteDevServer.middlewares);
+} else {
+  app.use(
+    express.static(path.join(epicshopAppRootDir, "build/client"), {
+      maxAge: isProd ? "1h" : 0
+    })
+  );
+}
+if (process.env.NODE_ENV !== "production" && !isPublished || isDeployed) {
+  morgan.token("url", (req) => decodeURIComponent(req.url ?? ""));
+  app.use(morgan("tiny"));
+}
+function getNumberOrNull(value) {
+  if (value == null) return null;
+  const number = Number(value);
+  return Number.isNaN(number) ? null : number;
+}
+app.use((req, res, next) => {
+  const [path2 = "", search] = req.url.split("?");
+  const segments = path2.split("/").map((s) => s.trim()).filter(Boolean);
+  let [first, second, ...rest] = segments;
+  let leading = "";
+  if (segments[0] === "app") {
+    leading = "/app";
+    [first, second, ...rest] = segments.slice(1);
+  }
+  if (segments[0] === "exercise") {
+    leading = "/exercise";
+    [first, second, ...rest] = segments.slice(1);
+  }
+  const firstNumber = getNumberOrNull(first);
+  const secondNumber = getNumberOrNull(second);
+  if (firstNumber === null && secondNumber === null) return next();
+  if (firstNumber != null) first = firstNumber.toString().padStart(2, "0");
+  if (secondNumber != null) second = secondNumber.toString().padStart(2, "0");
+  const updatedPath = `${leading}/${[first, second, ...rest].filter(Boolean).join("/")}`;
+  const updatedUrl = search ? `${updatedPath}?${search}` : updatedPath;
+  if (req.url !== updatedUrl) {
+    return res.redirect(302, updatedUrl);
+  }
+  next();
+});
+async function getBuild() {
+  const build = viteDevServer ? viteDevServer.ssrLoadModule("virtual:react-router/server-build") : (
+    // @ts-ignore this should exist before running the server
+    // but it may not exist just yet.
+    await import("#build/server/index.js")
+  );
+  return build;
+}
+app.all(
+  "*splat",
+  createRequestHandler({
+    getLoadContext: () => ({ serverBuild: getBuild() }),
+    mode: MODE,
+    build: getBuild
+  })
+);
+const desiredPort = Number(process.env.PORT || 5639);
+const portToUse = await getPort({
+  port: portNumbers(desiredPort, desiredPort + 100)
+});
+const localIp = ipAddress() ?? "Unknown";
+const lanUrl = /^10[.]|^172[.](1[6-9]|2[0-9]|3[0-1])[.]|^192[.]168[.]/.test(
+  localIp
+) ? `http://${localIp}:${portToUse}` : null;
+const server = app.listen(portToUse, async () => {
+  const addy = server.address();
+  const portUsed = desiredPort === portToUse ? desiredPort : addy && typeof addy === "object" ? addy.port : 0;
+  if (portUsed !== desiredPort) {
+    console.warn(
+      chalk.yellow(
+        `\u26A0\uFE0F  Port ${desiredPort} is not available, using ${portUsed} instead.`
+      )
+    );
+  }
+  console.log(`\u{1F428}  Let's get learning!`);
+  const localUrl = `http://localhost:${portUsed}`;
+  console.log(
+    `
+${chalk.bold("Local:")}            ${chalk.cyan(localUrl)}
+${lanUrl ? `${chalk.bold("On Your Network:")}  ${chalk.cyan(lanUrl)}` : ""}
+${chalk.bold("Press Ctrl+C to stop")}
+	`.trim()
+  );
+  if (process.env.EPICSHOP_DEPLOYED !== "true" && process.env.EPICSHOP_ENABLE_WATCHER === "true") {
+    const watches = /* @__PURE__ */ new Map();
+    const wss = new WebSocketServer({ noServer: true });
+    server.on("upgrade", (request, socket, head) => {
+      const url = new URL(request.url ?? "/", "ws://localhost:0000");
+      if (url.pathname === "/__ws") {
+        const origin = request.headers.origin;
+        const isValidOrigin = origin && (origin === `http://localhost:${portToUse}` || origin === `http://127.0.0.1:${portToUse}` || lanUrl && origin === lanUrl);
+        if (!isValidOrigin) {
+          socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
+          socket.destroy();
+          return;
+        }
+        wss.handleUpgrade(request, socket, head, (ws) => {
+          const watchPaths = url.searchParams.getAll("watch");
+          if (watchPaths.length === 0) {
+            socket.destroy();
+            return;
+          }
+          const key = watchPaths.join("&&");
+          let watcher = watches.get(key);
+          if (!watcher) {
+            const chok = chokidar.watch(watchPaths, {
+              cwd: getWorkshopRoot(),
+              ignoreInitial: true,
+              ignored: [
+                `/.git/`,
+                `/node_modules/`,
+                `/build/`,
+                `/server-build/`,
+                `/playwright-report/`,
+                `/dist/`,
+                `/.cache/`
+              ]
+            });
+            watcher = { clients: /* @__PURE__ */ new Set(), chok };
+            watches.set(key, watcher);
+            let timer = null;
+            let fileChanges = /* @__PURE__ */ new Set();
+            watcher.chok.on("all", (event, filePath) => {
+              fileChanges.add(path.join(getWorkshopRoot(), filePath));
+              if (timer) return;
+              timer = setTimeout(async () => {
+                for (const client of watcher?.clients ?? []) {
+                  client.send(
+                    JSON.stringify({
+                      type: "epicshop:file-change",
+                      data: { event, filePaths: Array.from(fileChanges) }
+                    })
+                  );
+                }
+                setModifiedTimesForAppDirs(...Array.from(fileChanges));
+                fileChanges = /* @__PURE__ */ new Set();
+                timer = null;
+              }, 50);
+            });
+          }
+          watcher.clients.add(ws);
+          ws.on("close", () => {
+            watcher?.clients.delete(ws);
+            if (watcher?.clients.size === 0) {
+              watches.delete(key);
+              void watcher.chok.close();
+            }
+          });
+        });
+      } else {
+        socket.destroy();
+      }
+    });
+    closeWithGrace(async () => {
+      await Promise.all([
+        ...Array.from(watches.values()).map((watcher) => watcher.chok.close()),
+        new Promise((resolve, reject) => {
+          wss.close((e) => e ? reject(e) : resolve("ok"));
+        })
+      ]);
+    });
+  }
+  const hasUpdates = await hasUpdatesPromise;
+  if (hasUpdates.updatesAvailable) {
+    const updateCommand = chalk.blue.bold.bgWhite(" npx update-epic-workshop ");
+    const updateLink = chalk.blue.bgWhite(` ${hasUpdates.diffLink} `);
+    console.log(
+      "\n",
+      `\u{1F389}  There are ${chalk.yellow(
+        "updates available"
+      )} for this workshop repository.  \u{1F389}
+
+To get the updates, ${chalk.green.bold.bgWhite(
+        `press the "u" key`
+      )} or stop the server and run the following command:
+
+  ${updateCommand}
+
+To view a diff, check:
+  ${updateLink}`
+    );
+  }
+});
+closeWithGrace(() => {
+  return new Promise((resolve, reject) => {
+    server.close((e) => e ? reject(e) : resolve());
+  });
+});

package/package.json

@@ -0,0 +1 @@
+{"name":"@epic-web/workshop-app","version":"0.0.0-semantically-released","sideEffects":false,"publishConfig":{"access":"public"},"bin":{"epicshop":"./bin/epicshop.js"},"files":["bin","build","dist","start.js"],"type":"module","imports":{"#app/*":"./app/*","#tests/*":"./tests/*","#build/*":"./build/*"},"exports":{"./start":{"default":"./start.js"}},"scripts":{"build":"run-p --print-label --print-name build:*","build:app":"react-router build --sourcemapClient --sourcemapServer","build:server":"tsx ./other/build-dir.ts server","dev":"node ./server/dev-server.js","format":"prettier --write .","lint":"eslint --cache --cache-location ./node_modules/.cache/eslint .","start":"cross-env NODE_ENV=production node ./start.js","typecheck":"react-router typegen && tsc --noEmit","validate":"run-p lint typecheck"},"dependencies":{"@conform-to/react":"^1.8.0","@conform-to/zod":"^1.8.0","@epic-web/cachified":"^5.6.0","@epic-web/client-hints":"^1.3.5","@epic-web/invariant":"^1.0.0","@epic-web/remember":"^1.1.0","@epic-web/restore-scroll":"^2.0.0","@epic-web/workshop-presence":"^5.29.2","@epic-web/workshop-utils":"^5.29.2","@mdx-js/mdx":"^3.1.0","@mux/mux-player-react":"^3.5.0","@nasa-gcn/remix-seo":"^2.0.1","@paralleldrive/cuid2":"^2.2.2","@radix-ui/react-accordion":"^1.2.11","@radix-ui/react-dialog":"^1.1.14","@radix-ui/react-popover":"^1.1.14","@radix-ui/react-select":"^2.2.5","@radix-ui/react-tabs":"^1.1.12","@radix-ui/react-toast":"^1.2.14","@radix-ui/react-tooltip":"^1.2.7","@react-router/express":"^7.6.3","@react-router/node":"^7.6.3","@react-router/remix-routes-option-adapter":"^7.6.3","@resvg/resvg-js":"^2.6.2","@sindresorhus/slugify":"^2.2.1","address":"^2.0.3","ansi-to-html":"^0.7.2","chalk":"^5.4.1","chokidar":"^4.0.3","close-with-grace":"^2.2.0","clsx":"^2.1.1","compression":"^1.8.0","confetti-react":"^2.6.0","cookie":"^1.0.2","cross-env":"^7.0.3","cross-spawn":"^7.0.6","dotenv":"^17.0.1","esbuild":"^0.25.5","etag":"^1.8.1","execa":"^9.6.0","express":"^5.1.0","fkill":"^9.0.0","framer-motion":"^12.23.0","fs-extra":"^11.3.0","get-port":"^7.1.0","glob":"^11.0.3","isbot":"^5.1.28","lru-cache":"^11.1.0","md5-hex":"^5.0.0","mdx-bundler":"^10.1.1","mermaid":"^11.8.0","mime-types":"^3.0.1","morgan":"^1.10.0","msw":"^2.10.2","open":"^10.1.2","openid-client":"^6.6.2","p-queue":"^8.1.0","partysocket":"^1.1.4","react":"^19.1.0","react-dom":"^19.1.0","react-router":"^7.6.3","remix-flat-routes":"^0.8.5","remix-utils":"^8.7.0","satori":"^0.15.2","shell-quote":"^1.8.3","sonner":"^2.0.6","source-map-support":"^0.5.21","spin-delay":"^2.0.1","tailwind-merge":"^2.6.0","vite-env-only":"^3.0.3","ws":"^8.18.3","zod":"^3.25.71"},"devDependencies":{"@playwright/test":"^1.53.2","@react-router/dev":"^7.6.3","@tailwindcss/typography":"^0.5.16","@testing-library/dom":"^10.4.0","@total-typescript/ts-reset":"^0.6.1","@types/compression":"^1.8.1","@types/cross-spawn":"^6.0.6","@types/etag":"^1.8.4","@types/express":"^5.0.3","@types/fs-extra":"^11.0.4","@types/hast":"^3.0.4","@types/lodash.escape":"^4.0.9","@types/mdast":"^4.0.4","@types/mime-types":"^3.0.1","@types/morgan":"^1.9.10","@types/node":"^24.0.10","@types/react":"^19.1.8","@types/react-dom":"^19.1.6","@types/shell-quote":"^1.7.5","@types/source-map-support":"^0.5.10","@types/wait-on":"^5.3.4","@types/ws":"^8.18.1","autoprefixer":"^10.4.21","eslint":"^9.30.1","mdast-util-mdx-jsx":"^3.2.0","npm-run-all":"^4.1.5","prettier":"^3.6.2","prettier-plugin-tailwindcss":"^0.6.13","tailwind-scrollbar":"^3.1.0","tailwindcss":"^3.4.13","tailwindcss-animate":"^1.0.7","tailwindcss-radix":"^3.0.5","tailwindcss-safe-area":"^0.6.0","tsx":"^4.20.3","typescript":"^5.8.3","vite":"^7.0.1"},"engines":{"node":"20 || 22 || 24"},"repository":{"type":"git","url":"https://github.com/epicweb-dev/epicshop.git","directory":"packages/workshop-app"}}

package/start.js

@@ -0,0 +1,50 @@
+import fs from 'fs/promises'
+import path from 'path'
+import dotenv from 'dotenv'
+
+if (process.env.EPICSHOP_SLOW_START === 'true') {
+	// slow start is used when doing the update-repo action to give time for the
+	// old server to exist before the new server starts (so ports are freed up).
+	await new Promise((resolve) => setTimeout(resolve, 1000))
+}
+
+const packageJson = JSON.parse(
+	await fs.readFile(path.resolve(process.cwd(), 'package.json'), 'utf-8'),
+)
+
+process.env.EPICSHOP_APP_VERSION ??= packageJson.version
+process.env.NODE_ENV ??= 'development'
+process.env.EPICSHOP_ENABLE_WATCHER ??= 'true'
+const EPICSHOP_CONTEXT_CWD = process.env.EPICSHOP_CONTEXT_CWD ?? process.cwd()
+dotenv.config({
+	quiet: true,
+	path: path.join(EPICSHOP_CONTEXT_CWD, '.env'),
+})
+
+if (process.env.NODE_ENV === 'production') {
+	await import('./dist/server/index.js').catch((err) => {
+		console.error(
+			'Encountered error importing the production server, exiting...',
+		)
+		console.error(err)
+		process.exit(1)
+	})
+} else {
+	await import('./server/index.ts').catch((err) => {
+		console.error(
+			'Encountered error importing the development server, exiting...',
+		)
+		console.error(err)
+		process.exit(1)
+	})
+}
+
+process.on('unhandledRejection', (reason, promise) => {
+	console.error(
+		'Unhandled Rejection for: ',
+		promise,
+		'\nWith the reason: ',
+		reason,
+	)
+	throw reason
+})