mayar 0.1.6 → 0.1.8

package/README.md

@@ -1,6 +1,6 @@
 # mayar
 
-Command-line interface for the [Mayar](https://docs.mayar.id) API. Production-only (`https://api.mayar.id`). Zero runtime dependencies — Node.js 18+ stdlib only.
+Command-line interface for the [Mayar](https://docs.mayar.id) API. Zero runtime dependencies — Node.js 18+ stdlib only.
 
 ## Install
 
@@ -13,26 +13,47 @@ npx mayar --help
 Or from source:
 
 ```bash
-git clone https://github.com/moerdowo/mayar-cli.git
+git clone https://github.com/mayarid/mayar-cli.git
 cd mayar-cli
 npm link        # exposes a `mayar` command on your PATH
 ```
 
-## First run
+## Authentication
 
-The first time you invoke any command, the CLI prints an ASCII banner and asks for your production API key (input is masked). Paste it once; it's stored at `~/.config/mayar/config.json` (chmod 600, follows the [XDG Base Directory](https://specification.freedesktop.org/basedir-spec/latest/) spec) and reused on subsequent runs.
+Resolution order: `--api-key` flag → `MAYAR_API_KEY` env → saved config file.
+
+**Option 1 — environment variable (recommended for CI/agents):**
+
+```bash
+export MAYAR_API_KEY=your_api_key_here
+mayar whoami
+```
+
+**Option 2 — saved config (interactive first run):**
+
+The first time you invoke any command without a key configured, the CLI prompts for your production API key (input is masked). Paste it once; it's stored at `~/.config/mayar/config.json` (chmod 600, follows [XDG Base Directory](https://specification.freedesktop.org/basedir-spec/latest/)) and reused on subsequent runs.
 
 ```bash
 mayar balance
-# ███╗   ███╗ █████╗ ██╗   ██╗ █████╗ ██████╗
-# ...
 # Welcome to Mayar CLI.
 # No API key found. Get yours from https://web.mayar.id → Integration → API Key.
 # Paste your production API key: ************
 # ✓ Saved to /Users/you/.config/mayar/config.json
 ```
 
-You can also run `mayar init` explicitly to (re-)configure the key, or pass `--api-key <key>` on any invocation to override.
+**Option 3 — non-interactive setup:**
+
+```bash
+mayar api-key YOUR_KEY_HERE
+```
+
+**Option 4 — per-command override:**
+
+```bash
+mayar --api-key YOUR_KEY_HERE balance
+```
+
+Get your API key from [web.mayar.id](https://web.mayar.id) → Integration → API Key.
 
 ## Commands
 
@@ -40,11 +61,11 @@ You can also run `mayar init` explicitly to (re-)configure the key, or pass `--a
 Setup
   init                                  Run first-time setup (interactive, masked input)
   api-key <key>                         Save API key non-interactively (e.g. for scripts)
-  config show                           Show masked saved key
+  config show                           Show masked saved key and config path
   config reset                          Remove the saved key
 
 Account
-  whoami                                Show merchant identity (decoded from JWT key) + verify
+  whoami                                Show merchant identity (decoded from JWT) + verify key
   balance                               GET /hl/v1/balance
 
 Invoices
@@ -94,14 +115,16 @@ Global flags
   -v, --version         Show version
 
 Environment
-  MAYAR_API_KEY         Used when --api-key is not given and no config is saved
+  MAYAR_API_KEY         API key — used when --api-key flag is absent and no config is saved
+  MAYAR_API_URL         Override API base URL (default: https://api.mayar.id)
 ```
 
-Resolution order: `--api-key` flag → `MAYAR_API_KEY` env → saved config.
-
 ## Examples
 
 ```bash
+# Verify active user / API key
+mayar whoami
+
 # Account balance
 mayar balance
 
@@ -146,10 +169,10 @@ mayar invoice list --json | jq '.data[] | {id, status}'
 
 ## Config
 
-| Key      | Value                                      |
-| -------- | ------------------------------------------ |
+| Key      | Value                                                                                       |
+| -------- | ------------------------------------------------------------------------------------------- |
 | Path     | `$XDG_CONFIG_HOME/mayar/config.json`, defaulting to `~/.config/mayar/config.json` (chmod 600) |
-| Endpoint | `https://api.mayar.id` (production, fixed) |
+| Endpoint | `MAYAR_API_URL` env or `https://api.mayar.id` (default)                                    |
 
 Legacy installs that wrote to `~/.mayar/config.json` are migrated automatically on first run.
 
@@ -157,6 +180,7 @@ To rotate keys: `mayar config reset && mayar init`.
 
 ## Notes
 
-- Sandbox is intentionally not supported — this CLI hits production only.
 - All requests use `Authorization: Bearer <key>`. Errors print `API <status> — <message>` and exit non-zero.
 - `--data @file.json` reads from disk; `--data '{...}'` reads inline JSON.
+- `MAYAR_API_URL` overrides the base URL — useful for staging or custom proxy environments.
+- `mayar whoami` decodes the JWT locally and verifies the key live against `/hl/v1/balance`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mayar",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Zero-dependency Node.js CLI for the Mayar API (production endpoint).",
   "bin": {
     "mayar": "bin/mayar.js"
@@ -23,13 +23,13 @@
   ],
   "author": "Frianto Moerdowo <frianto@duck.com>",
   "license": "MIT",
-  "homepage": "https://github.com/moerdowo/mayar-cli#readme",
+  "homepage": "https://github.com/mayarid/mayar-cli#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/moerdowo/mayar-cli.git"
+    "url": "git+https://github.com/mayarid/mayar-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/moerdowo/mayar-cli/issues"
+    "url": "https://github.com/mayarid/mayar-cli/issues"
   },
   "files": [
     "bin",

package/src/api.js

@@ -1,7 +1,7 @@
 const https = require('https');
 const { URL } = require('url');
 
-const BASE_URL = 'https://api.mayar.id';
+const BASE_URL = process.env.MAYAR_API_URL || 'https://api.mayar.id';
 const VERSION = require('../package.json').version;
 
 function request(method, pathname, { apiKey, body, query } = {}) {

package/src/cli.js

@@ -66,9 +66,10 @@ ${ui.bold('Global flags:')}
 
 ${ui.bold('Environment:')}
   MAYAR_API_KEY         Used when --api-key is not given and no config is saved
+  MAYAR_API_URL         Override API base URL (default: https://api.mayar.id)
 
 ${ui.dim('Resolution order: --api-key flag > MAYAR_API_KEY env > saved config.')}
-${ui.dim('Endpoint: https://api.mayar.id (production only)')}
+${ui.dim('Endpoint: MAYAR_API_URL env or https://api.mayar.id (default)')}
 ${ui.dim('Config:   ~/.config/mayar/config.json (chmod 600)')}
 `;