elm-ssr 0.5.0 → 0.5.1

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

@@ -56,15 +56,32 @@ 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":
+    requireConfig();
     await run("bun", ["run", "build"], rootPath);
     await run("./node_modules/.bin/wrangler", ["dev"], rootPath);
     break;
@@ -87,12 +104,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.1",
   "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>",