elm-ssr 0.5.0 → 0.5.2

package/README.md

@@ -1,11 +1,11 @@
 # elm-ssr
 
-Elm-first SSR library and framework for Cloudflare Workers (and Bun locally).
+Elm-first SSR library and framework for Fetch-compatible runtimes.
 One package, three pieces:
 
 - A **CLI** (`elm-ssr build|new|migrate|dev`) that scans your routes/islands,
   generates the router + manifest, and runs `elm make`.
-- A **Worker runtime** (`createWorkerApp`, `renderApp`, effect adapters,
+- A **Fetch-compatible runtime** (`createWorkerApp`, `renderApp`, effect adapters,
   background tasks, SQL migrations, middleware) exported via subpaths.
 - A set of **Elm authoring modules** under `elm-src/ElmSsr/` (Route, Loader,
   Action, Html, Svg, Island, Page, Document, Runtime) which the build syncs
@@ -17,8 +17,12 @@ One package, three pieces:
 bun add elm-ssr
 ```
 
-Then use the CLI as `elm-ssr <command>` (or `bun elm-ssr <command>` in a
-workspace) and import the runtime via subpaths.
+Then import the runtime via subpaths and run the CLI with `bunx`:
+
+```sh
+bunx elm-ssr new my-app
+bunx elm-ssr build
+```
 
 ## CLI commands
 
@@ -29,7 +33,9 @@ workspace) and import the runtime via subpaths.
   (one combined island bundle exposing `Elm.<App>.Islands.<Name>`).
 - **`elm-ssr new <name>`** — scaffold a new app and register it in
   `elm-ssr.config.json`.
-- **`elm-ssr dev`** — `build` then `wrangler dev`.
+- **`elm-ssr dev`** — `build` then `wrangler dev` for Cloudflare-like local
+  development. For other hosts, build with `elm-ssr build` and adapt
+  `worker.fetch` in your own server/entrypoint.
 - **`elm-ssr compress`** — pre-compress generated bundles with gzip.
 - **`elm-ssr migrate <up|down|status>`** — apply / revert / inspect SQL-file
   migrations. `--db postgres://…`, `sqlite://path`, or a plain SQLite file path;

package/bin/elm-ssr.mjs

@@ -8,14 +8,6 @@ import { build } from "../lib/build.mjs";
 import { migrate } from "../lib/migrate.mjs";
 
 const defaultRootPath = process.cwd();
-const packageJsonPath = resolve(defaultRootPath, "package.json");
-
-let packageJson = { name: "unknown" };
-try {
-  packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
-} catch {
-  // Not in a package root, that's okay for some commands
-}
 const args = process.argv.slice(2);
 const command = args[0] ?? "help";
 
@@ -25,6 +17,14 @@ const findFlagValue = (flagName) => {
 };
 
 const rootPath = resolve(findFlagValue("--root") ?? defaultRootPath);
+const packageJsonPath = resolve(rootPath, "package.json");
+
+let packageJson = { name: "unknown" };
+try {
+  packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+} catch {
+  // Not in a package root, that's okay for some commands
+}
 
 const run = async (cmd, cmdArgs, cwd = rootPath) => {
   const child = Bun.spawn([cmd, ...cmdArgs], {
@@ -56,18 +56,69 @@ const printHelp = () => {
 `);
 };
 
-const config = await readWorkspaceConfig(rootPath);
+let config = null;
+try {
+  config = await readWorkspaceConfig(rootPath);
+} catch (err) {
+  if (!err || typeof err !== "object" || !("code" in err) || err.code !== "ENOENT") {
+    throw err;
+  }
+}
+
+const requireConfig = () => {
+  if (!config) {
+    console.error(`Error: elm-ssr.config.json not found at ${rootPath}`);
+    console.error("Please run 'elm-ssr new <name>' to create a new workspace and app.");
+    process.exit(1);
+  }
+};
 
 switch (command) {
   case "build":
   case "compress":
+    requireConfig();
     await build({ rootPath, config });
     break;
 
-  case "dev":
-    await run("bun", ["run", "build"], rootPath);
-    await run("./node_modules/.bin/wrangler", ["dev"], rootPath);
+  case "dev": {
+    requireConfig();
+    if (packageJson && packageJson.scripts && packageJson.scripts.build) {
+      await run("bun", ["run", "build"], rootPath);
+    } else {
+      await build({ rootPath, config });
+    }
+
+    let wranglerCmd = "./node_modules/.bin/wrangler";
+    let wranglerArgs = ["dev"];
+    try {
+      await readFile(resolve(rootPath, wranglerCmd));
+    } catch {
+      wranglerCmd = "bunx";
+      wranglerArgs = ["wrangler", "dev"];
+    }
+
+    let hasWranglerConfig = false;
+    try {
+      const tomlContent = await readFile(resolve(rootPath, "wrangler.toml"), "utf8");
+      if (tomlContent.trim().length > 0) hasWranglerConfig = true;
+    } catch {}
+    try {
+      const jsonContent = await readFile(resolve(rootPath, "wrangler.jsonc"), "utf8");
+      if (jsonContent.trim().length > 0) hasWranglerConfig = true;
+    } catch {}
+
+    if (!hasWranglerConfig) {
+      const app = config.apps[0];
+      if (app) {
+        wranglerArgs.push(`${app.root}/worker.ts`);
+        wranglerArgs.push("--compatibility-date", "2026-05-28");
+        wranglerArgs.push("--compatibility-flags", "nodejs_compat");
+      }
+    }
+
+    await run(wranglerCmd, wranglerArgs, rootPath);
     break;
+  }
 
   case "new": {
     const name = args[1];
@@ -87,12 +138,14 @@ switch (command) {
   }
 
   case "routes":
+    requireConfig();
     for (const app of config.apps) {
       console.log(`${app.name}: root=${app.root} module=${app.module} routes=src/${app.module.split(".").join("/")}/Routes`);
     }
     break;
 
   case "info":
+    requireConfig();
     console.log(`workspace: ${packageJson.name}`);
     console.log(`apps: ${config.apps.map((app) => app.name).join(", ")}`);
     break;

package/lib/scaffold.mjs

@@ -475,7 +475,16 @@ const normalizeAppRoot = (rawRoot, name) => {
 export const createAppScaffold = async (rootPath, name, options = {}) => {
   ensureValidName(name);
 
-  const config = await readWorkspaceConfig(rootPath);
+  let config;
+  try {
+    config = await readWorkspaceConfig(rootPath);
+  } catch (err) {
+    if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
+      config = { apps: [] };
+    } else {
+      throw err;
+    }
+  }
   ensureAppMissing(config, name);
 
   const appRoot = normalizeAppRoot(options.root, name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elm-ssr",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Elm-first SSR library and framework for Cloudflare Workers (and Bun): file-based routes/islands, backend-neutral effect adapters (KV/D1/Redis/Postgres), background tasks (waitUntil/Queues), SQL-file migrations, CLI scaffold + build.",
   "license": "MIT",
   "author": "Michał Majchrzak <michmajchrzak@gmail.com>",