glashjs 0.10.0 → 0.11.1

package/README.md

@@ -75,10 +75,19 @@ export const POST = (ctx) => json({ created: ctx.body }, { status: 201 });
 ```
 
 ```bash
-glash dev      # dev server: routing + SSR + API, live route reload
-glash serve    # production server over routes/ + built assets (Brotli-negotiated)
+glashjs dev      # dev server (live reload) — prints a Local + Network (LAN IP) URL
+                 #   ➜ Local:    http://localhost:3000
+                 #   ➜ Network:  http://192.168.1.57:3000   (open from your phone/other devices)
+glashjs serve    # production server over routes/ + built assets (Brotli-negotiated)
+glashjs update   # update glashjs to the latest published version
+glashjs build    # optimize assets + precompile routes
+glashjs deploy   # build, then deploy to glashdb
 ```
 
+> glashjs installs **two** bins — `glashjs` and `glash` — both run the same CLI.
+> Use **`glashjs <cmd>`** in projects that also have the `@glash/cli`/`glashdb`
+> deploy CLI installed, since that package owns the `glash` name there.
+
 **`<Image>`** (better than `next/image` — no runtime image server, uses the build's AVIF/WebP):
 ```jsx
 import { Image } from 'glashjs/image';

package/bin/glash.mjs

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 // glashjs CLI
 import { readFileSync } from 'node:fs';
+import os from 'node:os';
 import { build } from '../src/build.mjs';
 import { optimizeAssets } from '../src/assets/optimize.mjs';
 import { createGlashServer } from '../src/server/server.mjs';
 import { deploy } from '../src/deploy.mjs';
+import { update } from '../src/update.mjs';
 
 const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
 const [, , cmd, ...rest] = process.argv;
@@ -14,17 +16,34 @@ function arg(name, fallback) {
   return i >= 0 && rest[i + 1] ? rest[i + 1] : fallback;
 }
 
+// LAN IPv4 addresses, so the dev server prints a Network URL you can open from
+// your phone or another device on the same network.
+function lanAddresses() {
+  const out = [];
+  const ifaces = os.networkInterfaces();
+  for (const name of Object.keys(ifaces)) {
+    for (const i of ifaces[name] || []) {
+      if (i.family === 'IPv4' && !i.internal) out.push(i.address);
+    }
+  }
+  return out;
+}
+
 async function serve(dev) {
   const root = arg('--root', process.cwd());
   const { listen, cfg, routes } = await createGlashServer({ root, dev });
   const port = Number(arg('--port', cfg.port || 3000));
-  const { host } = await listen(port);
+  await listen(port);
   const pages = routes.filter((r) => !r.isApi).length;
   const apis = routes.filter((r) => r.isApi).length;
   console.log(`\nglashjs ${dev ? 'dev' : 'serve'} — "${cfg.name}"`);
   console.log(`  ${pages} page route(s), ${apis} api route(s)`);
   routes.forEach((r) => console.log(`    ${r.isApi ? 'api ' : 'page'}  ${r.pattern}`));
-  console.log(`\n  ▶ http://localhost:${port}${dev ? '   (live route reload)' : ''}\n`);
+  console.log('');
+  console.log(`  ➜ Local:    http://localhost:${port}`);
+  for (const ip of lanAddresses()) console.log(`  ➜ Network:  http://${ip}:${port}   (preview on other devices)`);
+  if (dev) console.log('\n  live reload on save · ctrl-c to stop');
+  console.log('');
 }
 
 async function main() {
@@ -38,6 +57,10 @@ async function main() {
       await deploy({ root: arg('--root', process.cwd()), dryRun: rest.includes('--dry-run'), args: passthrough });
       break;
     }
+    case 'update':
+    case 'upgrade':
+      await update({ root: arg('--root', process.cwd()) });
+      break;
     case 'dev':
       await serve(true);
       break;
@@ -61,13 +84,14 @@ async function main() {
     default:
       console.log(`glashjs — fast, offline-capable, hard-to-hack sites
 
-Usage:
-  glash dev [--port 3000]       Run the dev server (file-based routing, SSR, API, live reload)
-  glash serve [--port 3000]     Run the production server over routes/ + built assets
-  glash build [--root <dir>]    Optimize assets, generate offline SW + PWA + security manifests
-  glash deploy [--dry-run]      Build, then deploy to glashdb (hands off to the glashdb CLI)
-  glash optimize [<dir>]        Just run the asset optimizer over a directory
-  glash version                 Print version
+Usage: (run as "glashjs <cmd>"; "glash <cmd>" also works unless the glashdb deploy CLI owns that name)
+  glashjs dev [--port 3000]     Run the dev server (routing, SSR, API, live reload) + Network preview URL
+  glashjs serve [--port 3000]   Run the production server over routes/ + built assets
+  glashjs build [--root <dir>]  Optimize assets, precompile routes, generate offline SW + PWA + security
+  glashjs update                Update glashjs to the latest published version
+  glashjs deploy [--dry-run]    Build, then deploy to glashdb (hands off to the glashdb CLI)
+  glashjs optimize [<dir>]      Just run the asset optimizer over a directory
+  glashjs version               Print version
 
 Docs: ./README.md`);
   }

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "glashjs",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "glashjs — a web framework built on top of Next.js: file-based routing, SSR, API routes, JSX components with client hydration, nested layouts, streaming SSR, a best-in-class build-time asset optimizer, offline PWA layer, animated favicon, and secure-by-default headers. Zero mandatory dependencies.",
   "type": "module",
   "bin": {
+    "glashjs": "bin/glash.mjs",
     "glash": "bin/glash.mjs"
   },
   "exports": {

package/src/index.mjs

@@ -1,6 +1,8 @@
 // glashjs public API
 export { defineConfig, loadConfig, DEFAULT_CONFIG } from './config.mjs';
 export { build } from './build.mjs';
+export { deploy } from './deploy.mjs';
+export { update } from './update.mjs';
 export { optimizeAssets } from './assets/optimize.mjs';
 export { generateAnimatedFavicon } from './assets/animated-favicon.mjs';
 export { generateServiceWorker } from './offline/generate-sw.mjs';

package/src/update.mjs

@@ -0,0 +1,39 @@
+// glashjs update — bump the installed glashjs to the latest published version,
+// using whichever package manager the project uses (npm/pnpm/yarn/bun).
+import { spawn } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+
+function installedVersion(root) {
+  try {
+    return JSON.parse(readFileSync(path.join(root, 'node_modules/glashjs/package.json'), 'utf8')).version;
+  } catch {
+    return null;
+  }
+}
+
+function packageManager(root) {
+  if (existsSync(path.join(root, 'pnpm-lock.yaml'))) return { cmd: 'pnpm', args: ['add', 'glashjs@latest'] };
+  if (existsSync(path.join(root, 'yarn.lock'))) return { cmd: 'yarn', args: ['add', 'glashjs@latest'] };
+  if (existsSync(path.join(root, 'bun.lockb'))) return { cmd: 'bun', args: ['add', 'glashjs@latest'] };
+  return { cmd: 'npm', args: ['install', 'glashjs@latest'] };
+}
+
+function run(cmd, args, root) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { cwd: root, stdio: 'inherit', shell: process.platform === 'win32' });
+    child.on('error', reject);
+    child.on('exit', (code) => (code === 0 ? resolve() : reject(new Error(`${cmd} exited with code ${code}`))));
+  });
+}
+
+export async function update({ root = process.cwd(), log = console.log } = {}) {
+  const current = installedVersion(root);
+  const { cmd, args } = packageManager(root);
+  log(`glashjs update — current: ${current ?? 'not installed'}\n  $ ${cmd} ${args.join(' ')}\n`);
+  await run(cmd, args, root);
+  const next = installedVersion(root);
+  if (next && next === current) log(`\n✓ already on the latest version (${next})`);
+  else log(`\n✓ glashjs is now ${next ?? 'installed'}${current ? ` (was ${current})` : ''}`);
+  return { from: current, to: next };
+}