@jacebenson/jsn 0.0.3 → 0.0.5

package/README.md

@@ -2,17 +2,28 @@
 
 A command-line interface for ServiceNow that follows the Unix philosophy: simple, composable, and scriptable.
 
+## Versions
+
+| Version | Language | Branch | Install | Status |
+|---------|----------|--------|---------|--------|
+| Go | Go | `main` | Binary / `go install` | Stable |
+| Node.js | JavaScript (Node 18+) | `nodejs` | `npm install -g` | Active development |
+
+Both versions share the same CLI interface and are tested against the same ServiceNow PDI.
+
 ## Installation
 
-### npm (Cross-platform — recommended for Windows)
+### npm (Node.js version — cross-platform)
 
 ```bash
-npm install -g @jacebenson/jsn
+npm install -g @jacebenson/jsn@node
 ```
 
-Works on macOS, Linux, and Windows. The correct binary for your platform is downloaded automatically during install.
+> **Note:** The `@node` dist-tag is required. The `latest` tag currently points to the Go shim wrapper (v1.0.1).
 
-### Download Binary
+No compilation needed. Works on macOS, Linux, and Windows with Node.js 18+.
+
+### Download Binary (Go version)
 
 ```bash
 # Download the latest release
@@ -21,7 +32,7 @@ chmod +x jsn
 sudo mv jsn /usr/local/bin/
 ```
 
-### Go Install
+### Go Install (Go version)
 
 ```bash
 go install github.com/jacebenson/jsn/cmd/jsn@latest
@@ -307,7 +318,7 @@ jsn auth status
 jsn auth logout
 ```
 
-Credentials are securely stored in your OS keychain (or file fallback at `~/.config/servicenow/credentials/`).
+Credentials are stored in `~/.config/servicenow/credentials/` (file-based, OS keychain coming soon).
 
 ## Environment Variables
 
@@ -331,6 +342,8 @@ jsn incidents list
 
 ## Shell Completion
 
+> **Note:** Shell completion is available in the Go version only.
+
 ```bash
 # Bash
 source <(jsn completion bash)
@@ -381,10 +394,39 @@ Error (usage): Instance URL required. Set via --instance flag, SERVICENOW_INSTAN
 - `--instance` flag
 - `SERVICENOW_INSTANCE_URL` environment variable
 
+## Development
+
+This repository maintains two parallel implementations:
+
+- **`main`** — Go implementation (stable)
+- **`nodejs`** — Node.js implementation (active development)
+
+Both branches share the same CLI interface and are kept in sync for feature parity.
+
+### Node.js version
+
+```bash
+git checkout nodejs
+npm install
+npm test        # Run tests
+npm run lint    # Run ESLint
+npm run start   # Run CLI locally
+```
+
+### Releasing
+
+```bash
+# From nodejs branch — creates node-v* tag and publishes to npm
+npm run release -- patch
+
+# From main branch — creates go-v* tag and builds binaries
+npm run release -- patch
+```
+
 ## Contributing
 
 1. Fork the repository
-2. Create a feature branch
+2. Create a feature branch (target the appropriate branch: `main` or `nodejs`)
 3. Make your changes
 4. Add tests
 5. Submit a pull request

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jacebenson/jsn",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "A command-line interface for ServiceNow that follows the Unix philosophy: simple, composable, and scriptable.",
   "type": "module",
   "bin": {
@@ -26,13 +26,13 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "@inquirer/prompts": "^7.5.1",
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@inquirer/prompts": "^7.5.1",
     "globals": "^17.6.0"
   },
   "files": [

package/src/auth.js

@@ -178,11 +178,11 @@ export class AuthManager {
     const open = (await import('node:child_process')).spawn;
     const platform = process.platform;
     const cmd = platform === 'darwin' ? 'open' : platform === 'win32' ? 'start' : 'xdg-open';
-    try {
-      open(cmd, [authURL], { detached: true, stdio: 'ignore' });
-    } catch {
-      // ignore
-    }
+    const child = open(cmd, [authURL], { detached: true, stdio: 'ignore' });
+    child.on('error', () => {
+      // xdg-open not installed — user will open the URL manually
+    });
+    child.unref();
 
     console.log('After authenticating in the browser, copy the authorization code shown on the page.');
     console.log('(input is hidden for security — just paste and press Enter)');