@dave-inthecloud/mirthsync 0.0.0-stage → 3.8.1

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+# @dave-inthecloud/mirthsync
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DevOps tool for Mirth Connect and Open Integration Engine version control and CI/CD automation.
+
+> **Fork notice:** this is a fork of [@saga-it/mirthsync](https://www.npmjs.com/package/@saga-it/mirthsync)
+> by Saga IT. It adds the orphan-check performance fix proposed upstream in
+> [SagaHealthcareIT/mirthsync#97](https://github.com/SagaHealthcareIT/mirthsync/pull/97)
+> (`pull` with a few hundred channels goes from minutes to seconds). Once that fix is
+> released upstream, switch back to `@saga-it/mirthsync`.
+
+## Installation
+
+```bash
+npm install -g @dave-inthecloud/mirthsync
+```
+
+## Prerequisites
+
+**Java JRE or JDK version 8 or higher is required.**
+
+If Java is not installed, mirthsync will display platform-specific installation instructions when you run it.
+
+### Quick Java Installation
+
+**macOS:**
+```bash
+brew install openjdk
+```
+
+**Linux (Debian/Ubuntu):**
+```bash
+sudo apt update && sudo apt install default-jre
+```
+
+**Linux (Fedora/RHEL):**
+```bash
+sudo dnf install java-latest-openjdk
+```
+
+**Windows:**
+```bash
+winget install Microsoft.OpenJDK.21
+```
+
+## Usage
+
+After installation, mirthsync is available globally:
+
+```bash
+# Show help
+mirthsync -h
+
+# Pull configuration from a Mirth Connect server
+mirthsync -s https://localhost:8443/api -u admin -p admin pull -t ./mirth-config
+
+# Push configuration to a server
+mirthsync -s https://localhost:8443/api -u admin -p admin push -t ./mirth-config
+
+# Git operations (no server credentials required)
+mirthsync -t ./mirth-config git status
+mirthsync -t ./mirth-config git add
+mirthsync -t ./mirth-config --commit-message "Updated channels" git commit
+```
+
+## Features
+
+- Synchronize channels, code templates, configuration maps, and global scripts
+- Built-in Git integration for version control
+- Token-based or username/password authentication
+- Orphaned file detection and cleanup
+- Bulk channel deployment
+- Multiple disk modes (backup, groups, items, code)
+- CI/CD pipeline integration
+
+## Documentation
+
+Product page: https://saga-it.com/products/mirthsync
+
+For complete documentation and source, visit:
+https://github.com/SagaHealthcareIT/mirthsync
+
+## License
+
+Eclipse Public License 1.0

package/bin/mirthsync.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+
+const { spawn, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const JAR_NAME = 'mirthsync.jar';
+
+function getJavaInstallInstructions() {
+  const platform = process.platform;
+
+  let instructions = `
+Java is required to run mirthsync but was not found on your system.
+
+`;
+
+  switch (platform) {
+    case 'darwin':
+      instructions += `To install Java on macOS:
+
+  Using Homebrew (recommended):
+    brew install openjdk
+
+  Or download from:
+    https://adoptium.net/
+
+  After installation, you may need to add Java to your PATH:
+    echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc
+    source ~/.zshrc
+`;
+      break;
+
+    case 'linux':
+      instructions += `To install Java on Linux:
+
+  Debian/Ubuntu:
+    sudo apt update && sudo apt install default-jre
+
+  Fedora/RHEL/CentOS:
+    sudo dnf install java-latest-openjdk
+
+  Arch Linux:
+    sudo pacman -S jre-openjdk
+
+  Or download from:
+    https://adoptium.net/
+`;
+      break;
+
+    case 'win32':
+      instructions += `To install Java on Windows:
+
+  Using winget:
+    winget install Microsoft.OpenJDK.21
+
+  Using Chocolatey:
+    choco install openjdk
+
+  Or download from:
+    https://adoptium.net/
+
+  After installation, you may need to restart your terminal.
+`;
+      break;
+
+    default:
+      instructions += `Please install Java JRE or JDK version 8 or higher.
+Download from: https://adoptium.net/
+`;
+  }
+
+  instructions += `
+Minimum required version: Java 8
+Recommended: Java 11, 17, or 21 (LTS versions)
+`;
+
+  return instructions;
+}
+
+function findJava() {
+  // Check if java is in PATH
+  const javaCommand = process.platform === 'win32' ? 'java.exe' : 'java';
+
+  // Try running java -version to check if it's available. As with the
+  // main spawn below, do not use a shell here: it is unnecessary for a
+  // no-argument detection call, and a shell launched when java is absent
+  // can still write to stderr, which would be misread as "java present".
+  const result = spawnSync(javaCommand, ['-version'], {
+    stdio: ['pipe', 'pipe', 'pipe'],
+    encoding: 'utf8'
+  });
+
+  if (!result.error && (result.status === 0 || result.stderr)) {
+    // Java outputs version to stderr
+    return javaCommand;
+  }
+
+  // Check JAVA_HOME
+  const javaHome = process.env.JAVA_HOME;
+  if (javaHome) {
+    const javaPath = path.join(javaHome, 'bin', javaCommand);
+    if (fs.existsSync(javaPath)) {
+      const homeResult = spawnSync(javaPath, ['-version'], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        encoding: 'utf8'
+      });
+      if (!homeResult.error && (homeResult.status === 0 || homeResult.stderr)) {
+        return javaPath;
+      }
+    }
+  }
+
+  return null;
+}
+
+function getJarPath() {
+  // The JAR is in ../lib/ relative to this script
+  return path.join(__dirname, '..', 'lib', JAR_NAME);
+}
+
+function main() {
+  // Find Java
+  const javaPath = findJava();
+
+  if (!javaPath) {
+    console.error(getJavaInstallInstructions());
+    process.exit(1);
+  }
+
+  // Find the JAR file
+  const jarPath = getJarPath();
+
+  if (!fs.existsSync(jarPath)) {
+    console.error(`Error: mirthsync JAR file not found at ${jarPath}`);
+    console.error('This may indicate a corrupted installation. Try reinstalling:');
+    console.error('  npm uninstall -g @dave-inthecloud/mirthsync');
+    console.error('  npm install -g @dave-inthecloud/mirthsync');
+    process.exit(1);
+  }
+
+  // Build the command arguments
+  const args = ['-jar', jarPath, ...process.argv.slice(2)];
+
+  // Spawn Java process with inherited stdio for full interactivity.
+  //
+  // Do NOT run this through a shell. With shell:true on Windows, Node
+  // concatenates the argv into a single command string without quoting
+  // (see Node's DEP0190 warning), so any argument containing a space —
+  // e.g. -r "Channels/Default Group/Sample Channel" — is word-split by the
+  // shell before Java ever sees it, and mirthsync fails to parse the command.
+  // Passing the argv array directly lets the runtime deliver each argument to
+  // Java verbatim, spaces and all, identically on every platform. A shell was
+  // never needed for resolution: findJava() always returns a concrete
+  // executable name ("java.exe") or absolute path, which spawn() locates on
+  // PATH on its own.
+  const child = spawn(javaPath, args, {
+    stdio: 'inherit'
+  });
+
+  // Forward signals to child process
+  const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+  signals.forEach(signal => {
+    process.on(signal, () => {
+      if (!child.killed) {
+        child.kill(signal);
+      }
+    });
+  });
+
+  // Exit with the same code as the Java process
+  child.on('close', (code) => {
+    process.exit(code || 0);
+  });
+
+  child.on('error', (err) => {
+    console.error(`Failed to start mirthsync: ${err.message}`);
+    process.exit(1);
+  });
+}
+
+main();

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@dave-inthecloud/mirthsync",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.8.1",
+  "description": "DevOps tool for Mirth Connect and Open Integration Engine version control and CI/CD automation (fork of @saga-it/mirthsync with the orphan-check performance fix)",
+  "keywords": [
+    "mirth",
+    "mirth-connect",
+    "open-integration-engine",
+    "oie",
+    "healthcare",
+    "hl7",
+    "fhir",
+    "dicom",
+    "devops",
+    "ci-cd",
+    "version-control",
+    "integration-engine"
+  ],
+  "homepage": "https://github.com/dave-InTheCloud/mirthsync#readme",
+  "bugs": {
+    "url": "https://github.com/dave-InTheCloud/mirthsync/issues"
+  },
+  "license": "EPL-1.0",
+  "author": "Saga IT LLC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dave-InTheCloud/mirthsync.git"
+  },
+  "bin": {
+    "mirthsync": "bin/mirthsync.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "preferGlobal": true,
+  "contributors": [
+    "dave-InTheCloud (https://github.com/dave-InTheCloud)"
+  ]
+}