cross-test 🛠️

Cross-platform shell-style conditions for package.json scripts.

cross-test is a lightweight, zero-dependency CLI utility that brings Unix-like test (or [ ]) functionality to any operating system. It allows you to write conditional logic in your package.json scripts that works identically on Windows, macOS, and Linux.

---

🚀 Why you need it

Standard shell conditions are not portable:

• Unix: [ -f dist/index.js ] && echo "Ready" (Fails on Windows CMD/PowerShell)
• Windows: if exist dist\index.js echo Ready (Fails on Bash/Zsh)
• cross-test: cross-test -f dist/index.js && echo "Ready" (Works everywhere)

✨ Features

• 📦 Zero Dependencies: Keeps your node_modules tiny.
• ⚡ ESM-Native: Built for the modern Node.js ecosystem.
• 🔧 Internal Variable Expansion: Supports $VAR and ${VAR} using process.env.
• 🧠 Smart Logic: Full support for !, -a (AND), -o (OR), and ( ) grouping.
• 🛡️ Provenance: Published with OIDC trusted publishing and SLSA provenance attestation.

---

📥 Installation

npm install --save-dev @kagal/cross-test

🛠 Usage

Use it directly in your package.json scripts:

{
  "scripts": {
    "dev": "cross-test -f dist/index.js || unbuild --stub",
    "deploy": "cross-test '$NODE_ENV' = 'production' && npm run surge",
    "check": "cross-test '(' -d .git -a -f .env ')' || echo 'Setup incomplete'"
  }
}

Supported Tests

Flag	Description
-f <path>	True if path is a file.
-d <path>	True if path is a directory.
-e <path>	True if path exists.
-s <path>	True if path exists and has size > 0.
-n <str>	True if string has non-zero length.
-z <str>	True if string is empty.
s1 = s2	True if string s1 equals s2.
s1 != s2	True if string s1 does not equal s2.

---

📖 Grammar

cross-test uses a recursive descent parser. Precedence from lowest to highest:

expr    = or ;
or      = and { "-o" and } ;
and     = primary { "-a" primary } ;
primary = "!" primary
        | "(" expr ")"
        | string ( "=" | "!=" ) string
        | ( "-n" | "-z" ) string
        | ( "-d" | "-e" | "-f" | "-s" ) path
        ;

Variables ($VAR, ${VAR}) are expanded from process.env before parsing.

---

🔒 Security

This package is published using OIDC trusted publishing and includes a verifiable SLSA provenance attestation. You can verify that the code in the npm package matches the source code in the GitHub repository.

📄 License

MIT © 2026