mayar 0.1.7 → 0.1.9

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
 
@@ -18,21 +18,42 @@ 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
@@ -72,10 +93,17 @@ Single payment requests
 Customers
   customer list [--page ...]            GET /hl/v1/customer
   customer create --data <json|@file>   POST /hl/v1/customer/create
+  customer search <email>               GET /hl/v1/customer/detail?email=
+  customer update <from> <to>           POST /hl/v1/customer/update
+  customer magic-link <email>           POST /hl/v1/customer/login/portal
 
 Transactions
   tx list   [--page ...]                GET /hl/v1/transactions          (paid)
   tx unpaid [--page ...]                GET /hl/v1/transactions/unpaid
+  tx daily                              GET /hl/v1/transactions/daily
+
+Reviews
+  review list [--page ...]              GET /hl/v1/reviews
 
 Dynamic QR
   qrcode <amount>                       POST /hl/v1/qrcode/create
@@ -94,14 +122,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 +176,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 +187,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.7",
+  "version": "0.1.9",
   "description": "Zero-dependency Node.js CLI for the Mayar API (production endpoint).",
   "bin": {
     "mayar": "bin/mayar.js"

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

@@ -43,10 +43,17 @@ ${ui.bold('Single payment requests:')}
 ${ui.bold('Customers:')}
   customer list [--page N --pageSize N]
   customer create --data <json|@file.json>
+  customer search <email>             Look up a customer by email
+  customer update <fromEmail> <toEmail>
+  customer magic-link <email>         Email a portal login link to the customer
 
 ${ui.bold('Transactions:')}
   tx list [--page N --pageSize N]     Paid transactions
   tx unpaid [--page N --pageSize N]   Unpaid transactions
+  tx daily                            Today's totals (volume + count)
+
+${ui.bold('Reviews:')}
+  review list [--page N --pageSize N]
 
 ${ui.bold('Dynamic QR:')}
   qrcode <amount>
@@ -66,9 +73,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)')}
 `;
 
@@ -169,6 +177,8 @@ async function run(argv) {
       qr:           './commands/qrcode',
       qrcode:       './commands/qrcode',
       webhook:      './commands/webhook',
+      review:       './commands/review',
+      reviews:      './commands/review',
     };
     const handler = handlers[cmd];
     if (!handler) {

package/src/commands/customer.js

@@ -2,10 +2,10 @@ const api = require('../api');
 const ui = require('../ui');
 const { checkResp, readData } = require('../util');
 
-const USAGE = 'Usage: mayar customer <list|create>';
+const USAGE = 'Usage: mayar customer <list|create|search|update|magic-link>';
 
 async function run({ apiKey, flags, positional }) {
-  const [sub] = positional;
+  const [sub, ...rest] = positional;
   switch (sub) {
     case 'list': {
       const res = await api.request('GET', '/hl/v1/customer', {
@@ -26,6 +26,28 @@ async function run({ apiKey, flags, positional }) {
       const res = await api.request('POST', '/hl/v1/customer/create', { apiKey, body });
       checkResp(res); ui.jsonOut(res.body); return;
     }
+    case 'search': {
+      if (!rest[0]) throw new Error('Usage: mayar customer search <email>');
+      const res = await api.request('GET', '/hl/v1/customer/detail', {
+        apiKey, query: { email: rest[0] },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'update': {
+      if (rest.length < 2) throw new Error('Usage: mayar customer update <fromEmail> <toEmail>');
+      const res = await api.request('POST', '/hl/v1/customer/update', {
+        apiKey, body: { fromEmail: rest[0], toEmail: rest[1] },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'magic-link':
+    case 'magiclink': {
+      if (!rest[0]) throw new Error('Usage: mayar customer magic-link <email>');
+      const res = await api.request('POST', '/hl/v1/customer/login/portal', {
+        apiKey, body: { email: rest[0] },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
     default:
       throw new Error(USAGE);
   }

package/src/commands/review.js

@@ -0,0 +1,42 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+const USAGE = 'Usage: mayar review <list>';
+
+function fmtDate(v) {
+  if (v == null) return '';
+  if (typeof v === 'number') return new Date(v).toISOString();
+  return String(v);
+}
+
+async function run({ apiKey, flags, positional }) {
+  const [sub] = positional;
+  switch (sub) {
+    case undefined:
+    case 'list': {
+      const res = await api.request('GET', '/hl/v1/reviews', {
+        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      const data = (res.body && res.body.data) || [];
+      const rows = data.map((r) => ({
+        id: r.id,
+        rating: r.rating,
+        customer: (r.customer && (r.customer.name || r.customer.email)) || '',
+        message: r.message || '',
+        status: r.status || '',
+        createdAt: fmtDate(r.createdAt),
+      }));
+      ui.table(rows, ['id', 'rating', 'customer', 'message', 'status', 'createdAt']);
+      const m = res.body || {};
+      process.stdout.write(ui.dim(`page ${m.page ?? '?'} / ${m.pageCount ?? '?'} · total ${m.total ?? data.length}`) + '\n');
+      return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/transaction.js

@@ -2,7 +2,7 @@ const api = require('../api');
 const ui = require('../ui');
 const { checkResp } = require('../util');
 
-const USAGE = 'Usage: mayar tx <list|unpaid>';
+const USAGE = 'Usage: mayar tx <list|unpaid|daily>';
 
 function fmtDate(v) {
   if (v == null) return '';
@@ -45,6 +45,17 @@ async function run({ apiKey, flags, positional }) {
       if (flags.json) return ui.jsonOut(res.body);
       renderTx(res.body); return;
     }
+    case 'daily': {
+      const res = await api.request('GET', '/hl/v1/transactions/daily', { apiKey });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      const d = (res.body && res.body.data) || {};
+      if (d.date)     process.stdout.write(`${ui.bold('Date:')}            ${d.date}\n`);
+      if (d.tpvCount != null) process.stdout.write(`${ui.bold('Total volume:')}   ${Number(d.tpvCount).toLocaleString('id-ID')}\n`);
+      if (d.trxCount != null) process.stdout.write(`${ui.bold('Transactions:')}   ${d.trxCount}\n`);
+      if (!d.date && !d.tpvCount && !d.trxCount) ui.jsonOut(res.body);
+      return;
+    }
     default:
       throw new Error(USAGE);
   }