@morphql/cli 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniele Traverso
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @morphql/cli
+
+CLI tool for **morphql** - structural data transformation powered by the Morph Query Language (MorphQL).
+
+## Installation
+
+```bash
+npm install -g @morphql/cli
+```
+
+## Usage
+
+```bash
+morphql [-f <input-file> | -i <raw-input>] [-t <output-file>] -q <query>
+```
+
+### Options
+
+- `-f, --from <path>`: Path to the source file (JSON, XML).
+- `-i, --input <string>`: Raw source content as a string.
+- `-t, --to <path>`: Path to the destination file. If omitted, result is printed to `stdout`.
+- `-q, --query <string>`: The MorphQL query to execute.
+- `--cache-dir <path>`: Directory for compiled cache (default: `.compiled`).
+
+### Examples
+
+**Transforming a file to another file:**
+
+```bash
+morphql --from ./data.json --to ./output.xml -q "from json to xml transform set fullName = firstName + \" \" + lastName"
+```
+
+**Transforming raw input to stdout (useful for piping):**
+
+```bash
+morphql -i '{"name": "John"}' -q "from json to xml"
+```
+
+**Piping output to another tool:**
+
+```bash
+morphql --from data.json -q "from json to json" | jq .
+```
+
+> [!NOTE]
+> All status and success messages are printed to `stderr`, ensuring that `stdout` contains only the transformation result.
+
+## Features
+
+- **Blazing Fast**: Compiles queries to native JavaScript for high performance.
+- **Smart Caching**: Standardized file-system caching to avoid re-compilation of queries.
+- **Format Agnostic**: Seamlessly convert between JSON and XML.
+- **Shell Friendly**: Supports raw input strings and stdout output for easy integration into pipelines.
+
+## License
+
+MIT

package/bin/morphql.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/index.ts
+import { compile } from "@morphql/core";
+
+// src/file-cache.ts
+import * as fs from "fs";
+import * as path from "path";
+import { createHash } from "crypto";
+var MorphQLFileCache = class {
+  cacheDir;
+  constructor(cacheDir = ".compiled") {
+    this.cacheDir = path.resolve(process.cwd(), cacheDir);
+  }
+  async retrieve(query) {
+    try {
+      const hash = this.getHash(query);
+      const filePath = path.join(this.cacheDir, `morph_${hash}.js`);
+      if (fs.existsSync(filePath)) {
+        return fs.promises.readFile(filePath, "utf8");
+      }
+    } catch (err) {
+    }
+    return null;
+  }
+  async save(query, code) {
+    try {
+      if (!fs.existsSync(this.cacheDir)) {
+        fs.mkdirSync(this.cacheDir, { recursive: true });
+      }
+      const hash = this.getHash(query);
+      const filePath = path.join(this.cacheDir, `morph_${hash}.js`);
+      const content = `/* 
+Query:
+${query}
+*/
+
+${code}`;
+      await fs.promises.writeFile(filePath, content, "utf8");
+    } catch (err) {
+    }
+  }
+  getHash(content) {
+    return createHash("sha256").update(content).digest("hex").substring(0, 12);
+  }
+};
+
+// src/index.ts
+import { Command } from "commander";
+import * as fs2 from "fs/promises";
+import * as path2 from "path";
+import { existsSync as existsSync2 } from "fs";
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+var program = new Command();
+program.name("morphql").description(
+  "CLI tool for morphql - transform structural data from the command line."
+).version("0.1.3").option("-f, --from <path>", "Path to the source file").option("-i, --input <string>", "Raw source content as string").option(
+  "-t, --to <path>",
+  "Path to the destination file (if omitted, result is printed to stdout)"
+).requiredOption("-q, --query <string>", "MorphQL query string").option("--cache-dir <path>", "Directory for compiled cache", ".compiled").action(async (options) => {
+  try {
+    const { from, input, to, query, cacheDir } = options;
+    let sourceContent;
+    if (input) {
+      sourceContent = input;
+    } else if (from) {
+      if (!existsSync2(from)) {
+        console.error(`Error: Source file not found: ${from}`);
+        process.exit(1);
+      }
+      sourceContent = await fs2.readFile(from, "utf8");
+    } else if (!process.stdin.isTTY) {
+      sourceContent = await readStdin();
+    } else {
+      console.error(
+        "Error: Either --from <path>, --input <string>, or pipe data via stdin must be provided."
+      );
+      process.exit(1);
+    }
+    const cache = new MorphQLFileCache(cacheDir);
+    const engine = await compile(query, { cache });
+    const result = await engine(sourceContent);
+    if (to) {
+      const destDir = path2.dirname(to);
+      if (!existsSync2(destDir)) {
+        await fs2.mkdir(destDir, { recursive: true });
+      }
+      await fs2.writeFile(to, result, "utf8");
+      console.error(`Successfully transformed to ${to}`);
+    } else {
+      console.log(result);
+    }
+  } catch (error) {
+    console.error(`Error during transformation: ${error.message}`);
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@morphql/cli",
+  "version": "0.1.3",
+  "description": "CLI tool for morphql - transform structural data from the command line.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "morphql": "./bin/morphql.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "lint": "eslint src/**/*.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "morphql",
+    "cli",
+    "transform",
+    "json",
+    "xml"
+  ],
+  "author": "Hyperwindmill",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hyperwindmill/morphql.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Hyperwindmill/morphql/issues"
+  },
+  "homepage": "https://github.com/Hyperwindmill/morphql/tree/main/packages/cli#readme",
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@morphql/core": "*",
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}