@maravilla-labs/cli 0.1.0

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2019 - 2025 SOLUTAS GmbH, Switzerland
+
+All Rights Reserved.
+-------------------------------------------------------
+NOTICE:
+All information contained herein is, and remains
+the property of SOLUTAS GmbH. The intellectual and
+technical concepts contained herein are confidential
+and proprietary to SOLUTAS GmbH. Dissemination of this
+information or reproduction of this material is strictly
+forbidden without the express written permission of
+SOLUTAS GmbH.

package/README.md

@@ -0,0 +1,45 @@
+# Maravilla CLI
+
+The official Maravilla command‑line tool.
+
+> Preview (early access)
+>
+> This package is being published for testing and early feedback. It’s not yet generally available and may change without notice. Not for production use. We welcome feedback and bug reports.
+
+## Install
+
+```bash
+npm install -g @maravilla-labs/cli
+# or
+pnpm add -g @maravilla-labs/cli
+# or
+yarn global add @maravilla-labs/cli
+```
+
+Verify:
+
+```bash
+maravilla --version
+```
+
+## Update
+
+```bash
+maravilla update
+```
+
+## What it does
+
+- Develop: start a local dev server with hot reload.
+- Build: produce optimized production artifacts for your app.
+- Preview: run a local server to preview your production build.
+- Platform tools: inspect status, browse KV and database collections.
+- Self‑update: fetch and install the latest CLI release.
+
+## Supported platforms
+
+- Linux x64 (GNU)
+- macOS x64 and arm64
+- Windows x64
+
+For other platforms and release notes, visit the Maravilla CLI releases page.

package/bin/maravilla

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Launcher that executes the downloaded Maravilla CLI binary in this package
+set -euo pipefail
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BIN="$DIR/maravilla"
+if [ "$(uname -s)" = "MINGW64_NT" ] || [ "$(uname -s)" = "MSYS_NT" ] || [ "$(uname -s)" = "CYGWIN_NT" ]; then
+  BIN="$DIR/maravilla.exe"
+fi
+exec "$BIN" "$@"

package/bin/maravilla.cmd

@@ -0,0 +1,4 @@
+@ECHO OFF
+SETLOCAL
+SET SCRIPT_DIR=%~dp0
+"%SCRIPT_DIR%maravilla.exe" %*

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@maravilla-labs/cli",
+  "version": "0.1.0",
+  "description": "NPM wrapper for the Maravilla CLI binary; downloads the right release for your platform.",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Maravilla Labs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/solutas/maravilla-runtime.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/solutas/maravilla-runtime/issues"
+  },
+  "homepage": "https://github.com/solutas/maravilla-runtime#readme",
+  "bin": {
+    "maravilla": "bin/maravilla"
+  },
+  "type": "module",
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js",
+    "download": "node ./scripts/postinstall.js",
+    "update": "node ./scripts/update.js",
+    "prepack": "node ./scripts/generate-readme-snippet.js || true"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2",
+    "tar": "^6.2.1",
+    "unzipper": "^0.10.14",
+    "progress": "^2.0.3",
+    "chalk": "^5.3.0"
+  }
+}

package/scripts/generate-readme-snippet.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// Placeholder for future automation; not required for functionality.
+console.log('');

package/scripts/platform.js

@@ -0,0 +1,15 @@
+// Map Node's process.platform/process.arch to GitHub release target triple and file ext
+export function resolveTarget() {
+  const p = process.platform;
+  const a = process.arch;
+  // Supported targets per release matrix
+  if (p === 'linux' && a === 'x64') return { target: 'x86_64-unknown-linux-gnu', ext: 'tar.gz' };
+  if (p === 'darwin' && a === 'x64') return { target: 'x86_64-apple-darwin', ext: 'tar.gz' };
+  if (p === 'darwin' && a === 'arm64') return { target: 'aarch64-apple-darwin', ext: 'tar.gz' };
+  if (p === 'win32' && a === 'x64') return { target: 'x86_64-pc-windows-msvc', ext: 'zip' };
+  throw new Error(`Unsupported platform/arch: ${p}/${a}. See https://github.com/maravilla-labs/maravilla-cli/releases for supported binaries.`);
+}
+
+export function artifactName(binName, tag, target) {
+  return `${binName}-${tag}-${target}`;
+}

package/scripts/postinstall.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+import { pipeline } from 'stream/promises';
+import fetch from 'node-fetch';
+import tar from 'tar';
+import unzipper from 'unzipper';
+import ProgressBar from 'progress';
+import chalk from 'chalk';
+import { resolveTarget, artifactName } from './platform.js';
+import crypto from 'crypto';
+
+// Allow CI to skip downloading the binary
+if (process.env.MARAVILLA_CLI_SKIP_INSTALL === '1' || process.env.CI) {
+  console.log('✿ Skipping Maravilla CLI binary install (CI or skip flag set)');
+  process.exit(0);
+}
+import { spawn } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const BIN_NAME = 'maravilla';
+const REPO = process.env.MARAVILLA_CLI_REPO || 'maravilla-labs/maravilla-cli';
+const VERSION = process.env.MARAVILLA_VERSION || 'latest'; // cli-vX.Y.Z or 'latest'
+const BIN_DIR = path.join(__dirname, '..', 'bin');
+const EXECUTABLE = process.platform === 'win32' ? `${BIN_NAME}.exe` : BIN_NAME;
+const INSTALL_PATH = path.join(BIN_DIR, EXECUTABLE);
+
+function flower() {
+  return chalk.magenta('✿');
+}
+
+function log(msg) {
+  console.log(`${flower()} ${msg}`);
+}
+
+async function getReleaseTag() {
+  if (VERSION && VERSION !== 'latest') return VERSION;
+  const api = `https://api.github.com/repos/${REPO}/releases/latest`;
+  const res = await fetch(api, { headers: { 'User-Agent': 'maravilla-cli-installer' } });
+  if (!res.ok) throw new Error(`Failed to fetch latest release: ${res.status} ${res.statusText}`);
+  const json = await res.json();
+  return json.tag_name;
+}
+
+async function downloadWithProgress(url, dest) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Failed to download ${url}: ${res.status} ${res.statusText}`);
+  const total = Number(res.headers.get('content-length')) || 0;
+  const bar = total ? new ProgressBar(`${flower()} downloading [:bar] :percent :etas`, {
+    complete: '=', incomplete: ' ', width: 24, total
+  }) : null;
+
+  await pipeline(
+    res.body,
+    new (class extends fs.WriteStream {
+      constructor(dest) { super(dest); }
+      write(chunk, enc, cb) { if (bar) bar.tick(chunk.length); super.write(chunk, enc, cb); }
+    })(dest)
+  );
+}
+
+async function extractArchive(archivePath, targetDir, ext) {
+  if (ext === 'tar.gz') {
+    await tar.x({ file: archivePath, cwd: targetDir });
+  } else if (ext === 'zip') {
+    await fs.createReadStream(archivePath).pipe(unzipper.Extract({ path: targetDir })).promise();
+  } else {
+    throw new Error(`Unknown archive type: ${ext}`);
+  }
+}
+
+async function install() {
+  const { target, ext } = resolveTarget();
+  const tag = await getReleaseTag();
+  const art = artifactName(BIN_NAME, tag, target);
+  const assetFile = `${art}.${ext}`;
+  const url = `https://github.com/${REPO}/releases/download/${tag}/${assetFile}`;
+  const sumsUrl = `https://github.com/${REPO}/releases/download/${tag}/SHA256SUMS`;
+
+  await fs.promises.mkdir(BIN_DIR, { recursive: true });
+  const tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'maravilla-cli-'));
+  const archive = path.join(tmpDir, assetFile);
+
+  log(chalk.bold(`Installing ${BIN_NAME} ${chalk.cyan(tag)} for ${chalk.cyan(target)}`));
+  log(`Downloading from ${url}`);
+  await downloadWithProgress(url, archive);
+
+  // Verify checksum if SHA256SUMS is available
+  try {
+    log('Verifying checksum');
+    const sumsRes = await fetch(sumsUrl, { headers: { 'User-Agent': 'maravilla-cli-installer' } });
+    if (sumsRes.ok) {
+      const sumsText = await sumsRes.text();
+      const expected = sumsText
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .map((l) => l.split(/\s+/)) // [hash, filename]
+        .find(([, fname]) => fname === assetFile);
+      if (!expected) throw new Error('Checksum entry not found for asset');
+      const [expectedHash] = expected;
+      const hash = await sha256File(archive);
+      if (hash !== expectedHash) {
+        throw new Error(`Checksum mismatch for ${assetFile}: expected ${expectedHash}, got ${hash}`);
+      }
+      log(chalk.green('Checksum OK'));
+    } else {
+      log(chalk.yellow('SHA256SUMS not found; skipping verification'));
+    }
+  } catch (e) {
+    console.error(chalk.red(`${flower()} checksum verification failed: ${e.message}`));
+    throw e;
+  }
+
+  log('Extracting archive');
+  await extractArchive(archive, tmpDir, ext);
+
+  const innerDir = path.join(tmpDir, art);
+  const srcPath = path.join(innerDir, EXECUTABLE);
+  await fs.promises.copyFile(srcPath, INSTALL_PATH);
+  await fs.promises.chmod(INSTALL_PATH, 0o755);
+  log(chalk.green(`Installed to ${INSTALL_PATH}`));
+
+  // Self-check: run --version
+  await new Promise((resolve, reject) => {
+    log('Verifying install by running --version');
+    const child = spawn(INSTALL_PATH, ['--version'], { stdio: ['ignore', 'pipe', 'pipe'] });
+    let out = '';
+    child.stdout.on('data', (d) => (out += d.toString()))
+    child.on('error', reject);
+    child.on('exit', (code) => {
+      if (code === 0) {
+        log(chalk.green(`Version: ${out.trim()}`));
+        resolve();
+      } else {
+        reject(new Error(`Version check failed with code ${code}`));
+      }
+    });
+  });
+}
+
+async function sha256File(filePath) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256');
+    const rs = fs.createReadStream(filePath);
+    rs.on('error', reject);
+    rs.on('data', (chunk) => hash.update(chunk));
+    rs.on('end', () => resolve(hash.digest('hex')));
+  });
+}
+
+install().catch(err => {
+  console.error(chalk.red(`${flower()} install failed: ${err.message}`));
+  process.exitCode = 1;
+});

package/scripts/update.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import path from 'path';
+import { spawn } from 'child_process';
+
+// Simply rerun the postinstall script to fetch latest/specified version
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const postinstall = path.join(__dirname, 'postinstall.js');
+
+const child = spawn(process.execPath, [postinstall], { stdio: 'inherit' });
+child.on('exit', (code) => process.exit(code ?? 0));