@junejs/cli 0.0.3 → 0.0.5

package/bin.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+// The `june` bin launcher. It runs on Node ON PURPOSE: the CLI itself
+// (src/june.ts) runs on Bun, and without this hop an npm user without Bun
+// gets a bare shebang error ("env: bun: No such file or directory") instead
+// of a sentence telling them what to install.
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const entry = join(dirname(fileURLToPath(import.meta.url)), "src/june.ts");
+const args = process.argv.slice(2);
+
+const probe = spawnSync("bun", ["--version"], { stdio: "ignore", shell: false });
+if (probe.error || probe.status !== 0) {
+  console.error(
+    "june: the June CLI runs on Bun, which wasn't found on your PATH.\n" +
+      "  install it:  curl -fsSL https://bun.sh/install | bash\n" +
+      "  (or: brew install oven-sh/bun/bun · https://bun.sh)",
+  );
+  process.exit(1);
+}
+
+const child = spawnSync("bun", [entry, ...args], { stdio: "inherit", shell: false });
+process.exit(child.status ?? 1);

package/package.json

@@ -1,26 +1,27 @@
 {
   "name": "@junejs/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "The `june` CLI — dev / build / deploy / gen / info. A thin bin over @junejs/server.",
   "type": "module",
   "license": "MIT",
   "homepage": "https://june.build",
   "bin": {
-    "june": "./src/june.ts"
+    "june": "./bin.mjs"
   },
   "exports": {
     ".": "./src/cli.ts"
   },
   "files": [
-    "src"
+    "src",
+    "bin.mjs"
   ],
   "scripts": {
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@junejs/core": "0.0.3",
-    "@junejs/server": "0.0.3"
+    "@junejs/core": "0.0.5",
+    "@junejs/server": "0.0.5"
   },
   "repository": {
     "type": "git",

package/src/cli.ts

@@ -2,6 +2,7 @@
 // @junejs/server. Exposed as run(argv) so it is testable without spawning a
 // process; the bin (june.ts) just forwards process.argv. See docs/cli.md.
 
+import { existsSync } from "node:fs";
 import { join, resolve } from "node:path";
 
 export type Parsed = {
@@ -85,6 +86,19 @@ export async function run(argv: string[]): Promise<number | undefined> {
 
   switch (verb) {
     case "dev": {
+      // Validate BEFORE the supervisor: watching a directory that doesn't
+      // exist throws a raw ENOENT, and the classic mistake `npm run dev -p
+      // 3001` hands us "3001" as the app dir (npm eats the flag).
+      if (!existsSync(join(root, "app"))) {
+        console.error(`june dev: ${root} doesn't look like a June app (no app/ directory).`);
+        if (/^\d+$/.test(positional[0] ?? "")) {
+          console.error(
+            `  to choose a port, use --port:  june dev --port ${positional[0]}` +
+              `  ·  npm run dev -- --port ${positional[0]}`,
+          );
+        }
+        return 1;
+      }
       // A restart is the reload: the watch supervisor respawns the serving
       // child on file change (see watch.ts). Children carry JUNE_DEV_CHILD.
       if (!process.env.JUNE_DEV_CHILD && !flags["no-watch"]) {