@govela/app 0.1.1 → 0.1.2

package/README.md

@@ -3,7 +3,22 @@
 The client router of Vela App, the application layer above the Vela compiler
 with a Go server. The contract is [docs/APP.md](../../docs/APP.md).
 
-This package is not published yet. `@govela/app/match` has the built-in
+It also installs the `vela-app` command, which generates the app sources,
+runs the development loop and makes production builds:
+
+```sh
+npm install @govela/app @govela/runtime
+npx vela-app dev
+npx vela-app build
+```
+
+`bin/vela-app.js` runs the binary of the optional dependency
+`@govela/app-<os>-<cpu>` for this platform (linux x64/arm64, macOS
+x64/arm64, Windows x64), or `$VELA_APP_BINARY`. Do not install with
+`--omit=optional`. The guide is
+[docs/VELA_APP.md](../../docs/VELA_APP.md).
+
+`@govela/app/match` has the built-in
 matchers (`int`, `uuid`, `slug`) and `matchPath`, which the route table that
 `vela-app gen` writes (`src/_app/routes.js`) uses; the Go package
 `github.com/elauven/vela/app` matches with the same rules.

package/bin/vela-app.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// The `vela-app` command of @govela/app: runs the vela-app binary of this
+// platform (the optional dependency @govela/app-<os>-<cpu>), or
+// $VELA_APP_BINARY, with the arguments, standard streams and exit code of
+// the command.
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const manifest = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const platforms = ['linux-x64', 'linux-arm64', 'darwin-x64', 'darwin-arm64', 'win32-x64'];
+
+function binaryPath() {
+  if (process.env.VELA_APP_BINARY) {
+    return process.env.VELA_APP_BINARY;
+  }
+  const platform = `${process.platform}-${process.arch}`;
+  const name = `${manifest.name}-${platform}`;
+  if (!platforms.includes(platform)) {
+    throw new Error(`vela-app: no prebuilt binary for ${platform}; supported: ${platforms.join(', ')}. Install it with \`go install github.com/elauven/vela/app/cmd/vela-app@v${manifest.version}\` and set VELA_APP_BINARY to it.`);
+  }
+  const file = `bin/vela-app${process.platform === 'win32' ? '.exe' : ''}`;
+  try {
+    return require.resolve(`${name}/${file}`);
+  } catch {
+    throw new Error(`vela-app: the package ${name} is not installed. It is an optional dependency of ${manifest.name}; reinstall without --no-optional / --omit=optional, or set VELA_APP_BINARY to a vela-app binary.`);
+  }
+}
+
+let binary;
+try {
+  binary = binaryPath();
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}
+const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit', windowsHide: true });
+if (result.error) {
+  console.error(`vela-app: cannot run ${binary}: ${result.error.message}`);
+  process.exit(1);
+}
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@govela/app",
-  "version": "0.1.1",
-  "description": "Client router of Vela App (docs/APP.md): hydration, data navigation and route matching.",
+  "version": "0.1.2",
+  "description": "Vela App (docs/APP.md): the client router (hydration, data navigation, route matching) and the vela-app command.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -9,6 +9,9 @@
     "directory": "packages/app"
   },
   "type": "module",
+  "bin": {
+    "vela-app": "bin/vela-app.js"
+  },
   "sideEffects": false,
   "exports": {
     "./client": {
@@ -21,6 +24,7 @@
     }
   },
   "files": [
+    "bin/vela-app.js",
     "client.js",
     "client.d.ts",
     "match.js",
@@ -33,5 +37,15 @@
   },
   "peerDependencies": {
     "@govela/runtime": ">=0.4.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@govela/app-darwin-arm64": "0.1.2",
+    "@govela/app-darwin-x64": "0.1.2",
+    "@govela/app-linux-arm64": "0.1.2",
+    "@govela/app-linux-x64": "0.1.2",
+    "@govela/app-win32-x64": "0.1.2"
   }
 }