@grafeo-db/cli 0.4.4

package/README.md

@@ -0,0 +1,63 @@
+# @grafeo-db/cli
+
+Command-line interface for [Grafeo](https://grafeo.dev) graph database, distributed via npm.
+
+## Installation
+
+```bash
+npm install -g @grafeo-db/cli
+# or
+npx @grafeo-db/cli --help
+```
+
+The correct platform-specific binary is installed automatically via optional dependencies.
+
+## Supported Platforms
+
+| Platform | Package |
+|----------|---------|
+| Linux x64 | `@grafeo-db/cli-linux-x64` |
+| Linux ARM64 | `@grafeo-db/cli-linux-arm64` |
+| macOS x64 | `@grafeo-db/cli-darwin-x64` |
+| macOS ARM64 | `@grafeo-db/cli-darwin-arm64` |
+| Windows x64 | `@grafeo-db/cli-win32-x64` |
+
+## Usage
+
+```bash
+# Database management
+grafeo info ./my-db
+grafeo stats ./my-db
+grafeo validate ./my-db
+
+# Query execution
+grafeo query ./my-db "MATCH (n:Person) RETURN n.name"
+
+# Interactive shell
+grafeo shell ./my-db
+
+# Create a new database
+grafeo init ./new-db
+```
+
+## Alternative Installation
+
+```bash
+# Via Rust
+cargo install grafeo-cli
+
+# Via pip
+pip install grafeo-cli
+
+# Direct download
+# https://github.com/GrafeoDB/grafeo/releases
+```
+
+## Links
+
+- [Documentation](https://grafeo.dev)
+- [GitHub](https://github.com/GrafeoDB/grafeo)
+
+## License
+
+AGPL-3.0-or-later

package/bin/grafeo.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+/**
+ * Grafeo CLI launcher for npm.
+ *
+ * Resolves the platform-specific binary from optional dependencies
+ * and spawns it with all arguments forwarded.
+ */
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const { existsSync } = require("fs");
+const { join } = require("path");
+const { platform, arch } = require("os");
+
+/** Map of Node.js platform/arch to package names and binary paths. */
+const PLATFORMS = {
+  "linux-x64": { pkg: "@grafeo-db/cli-linux-x64", bin: "grafeo" },
+  "linux-arm64": { pkg: "@grafeo-db/cli-linux-arm64", bin: "grafeo" },
+  "darwin-x64": { pkg: "@grafeo-db/cli-darwin-x64", bin: "grafeo" },
+  "darwin-arm64": { pkg: "@grafeo-db/cli-darwin-arm64", bin: "grafeo" },
+  "win32-x64": { pkg: "@grafeo-db/cli-win32-x64", bin: "grafeo.exe" },
+};
+
+function findBinary() {
+  const key = `${platform()}-${arch()}`;
+  const entry = PLATFORMS[key];
+
+  if (!entry) {
+    console.error(
+      `error: unsupported platform ${key}\n` +
+        `Supported: ${Object.keys(PLATFORMS).join(", ")}\n` +
+        "Install the binary manually: cargo install grafeo-cli"
+    );
+    process.exit(1);
+  }
+
+  // 1. Try platform-specific optional dependency
+  try {
+    const pkgDir = require.resolve(`${entry.pkg}/package.json`);
+    const binPath = join(pkgDir, "..", entry.bin);
+    if (existsSync(binPath)) {
+      return binPath;
+    }
+  } catch {
+    // Package not installed (optional dependency)
+  }
+
+  // 2. Try binary adjacent to this package (development installs)
+  const adjacent = join(__dirname, "..", entry.bin);
+  if (existsSync(adjacent)) {
+    return adjacent;
+  }
+
+  // 3. Fall back to system PATH
+  return entry.bin;
+}
+
+const binary = findBinary();
+
+try {
+  const result = execFileSync(binary, process.argv.slice(2), {
+    stdio: "inherit",
+    windowsHide: true,
+  });
+} catch (error) {
+  if (error.status != null) {
+    process.exit(error.status);
+  }
+
+  if (error.code === "ENOENT") {
+    console.error(
+      `error: grafeo binary not found.\n\n` +
+        `Install via one of:\n` +
+        `  npm install @grafeo-db/cli\n` +
+        `  cargo install grafeo-cli\n` +
+        `  Download from https://github.com/GrafeoDB/grafeo/releases\n`
+    );
+    process.exit(1);
+  }
+
+  console.error(`error: ${error.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@grafeo-db/cli",
+  "version": "0.4.4",
+  "description": "Command-line interface for Grafeo graph database",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GrafeoDB/grafeo",
+    "directory": "packages/grafeo-cli-npm"
+  },
+  "homepage": "https://grafeo.dev",
+  "keywords": [
+    "grafeo",
+    "graph",
+    "database",
+    "gql",
+    "cli"
+  ],
+  "bin": {
+    "grafeo": "bin/grafeo.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@grafeo-db/cli-linux-x64": "0.4.4",
+    "@grafeo-db/cli-linux-arm64": "0.4.4",
+    "@grafeo-db/cli-darwin-x64": "0.4.4",
+    "@grafeo-db/cli-darwin-arm64": "0.4.4",
+    "@grafeo-db/cli-win32-x64": "0.4.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}