mayar 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Frianto Moerdowo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# 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.
+
+## Install
+
+```bash
+npm install -g mayar
+# or run without installing:
+npx mayar --help
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/moerdowo/mayar-cli.git
+cd mayar-cli
+npm link        # exposes a `mayar` command on your PATH
+```
+
+## First run
+
+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 `~/.mayar/config.json` (chmod 600) 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/.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.
+
+## Commands
+
+```
+Setup
+  init                                  Run first-time setup
+  config show                           Show masked saved key
+  config reset                          Remove the saved key
+
+Account
+  balance                               GET /hl/v1/balance
+
+Invoices
+  invoice list [--page N --pageSize N]  GET /hl/v1/invoice
+  invoice get <id>                      GET /hl/v1/invoice/{id}
+  invoice close <id>                    GET /hl/v1/invoice/close/{id}
+  invoice reopen <id>                   GET /hl/v1/invoice/open/{id}
+  invoice create --data <json|@file>    POST /hl/v1/invoice/create
+
+Products
+  product list [--page N --pageSize N]  GET /hl/v1/product
+  product search <keyword>              GET /hl/v1/product?search=...
+  product type <type> [--page ...]      GET /hl/v1/product/type/{type}
+  product get <id>                      GET /hl/v1/product/{id}
+  product close <id>                    GET /hl/v1/product/close/{id}
+  product reopen <id>                   GET /hl/v1/product/open/{id}
+
+Single payment requests
+  payment list                          GET /hl/v1/payment
+  payment get <id>                      GET /hl/v1/payment/{id}
+  payment close <id>                    GET /hl/v1/payment/close/{id}
+  payment reopen <id>                   GET /hl/v1/payment/open/{id}
+  payment create --data <json|@file>    POST /hl/v1/payment/create
+
+Customers
+  customer list [--page ...]            GET /hl/v1/customer
+  customer create --data <json|@file>   POST /hl/v1/customer/create
+
+Transactions
+  tx list   [--page ...]                GET /hl/v1/transactions          (paid)
+  tx unpaid [--page ...]                GET /hl/v1/transactions/unpaid
+
+Dynamic QR
+  qrcode <amount>                       POST /hl/v1/qrcode/create
+
+Webhooks
+  webhook register <url>                GET /hl/v1/webhook/register
+  webhook test <url>                    POST /hl/v1/webhook/test
+  webhook history [--page ...]          GET /hl/v1/webhook/history
+
+Global flags
+  --json                Output raw JSON instead of pretty tables
+  --api-key <key>       Override saved key for this run
+  --page N              Pagination page (default 1)
+  --pageSize N          Pagination page size (default 10)
+  -h, --help            Show help
+  -v, --version         Show version
+```
+
+## Examples
+
+```bash
+# Account balance
+mayar balance
+
+# Paginated lists
+mayar invoice list --page 1 --pageSize 20
+mayar product type ebook --pageSize 50
+
+# Search
+mayar product search "kelas python"
+
+# Create an invoice from a JSON file
+cat > /tmp/inv.json <<'JSON'
+{
+  "name": "Andre",
+  "email": "andre@example.com",
+  "mobile": "08123456789",
+  "redirectUrl": "https://example.com/thanks",
+  "description": "Order #1234",
+  "expiredAt": "2026-12-31T23:59:59.000Z",
+  "items": [{ "quantity": 1, "rate": 50000, "description": "1x Course" }]
+}
+JSON
+mayar invoice create --data @/tmp/inv.json
+
+# Create a customer inline
+mayar customer create --data '{"name":"Raihan","email":"r@example.com","mobile":"081234567890"}'
+
+# Create a payment request
+mayar payment create --data '{"name":"X","email":"x@y.com","amount":170000,"mobile":"08123","redirectUrl":"https://m.com","description":"Test","expiredAt":"2026-12-31T00:00:00.000Z"}'
+
+# Dynamic QR for IDR 10,000
+mayar qrcode 10000
+
+# Webhooks
+mayar webhook register https://example.com/hooks/mayar
+mayar webhook test     https://example.com/hooks/mayar
+mayar webhook history --page 1 --pageSize 20
+
+# Pipe raw JSON to jq
+mayar invoice list --json | jq '.data[] | {id, status}'
+```
+
+## Config
+
+| Key      | Value                                      |
+| -------- | ------------------------------------------ |
+| Path     | `~/.mayar/config.json` (chmod 600)         |
+| Endpoint | `https://api.mayar.id` (production, fixed) |
+
+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.

package/bin/mayar.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../src/cli.js').run(process.argv.slice(2));

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "mayar",
+  "version": "0.1.0",
+  "description": "Zero-dependency Node.js CLI for the Mayar API (production endpoint).",
+  "bin": {
+    "mayar": "./bin/mayar.js"
+  },
+  "main": "src/cli.js",
+  "scripts": {
+    "start": "node bin/mayar.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mayar",
+    "mayar-api",
+    "payments",
+    "invoice",
+    "cli",
+    "indonesia",
+    "qris"
+  ],
+  "author": "Frianto Moerdowo <frianto@duck.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/moerdowo/mayar-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moerdowo/mayar-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/moerdowo/mayar-cli/issues"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/api.js

@@ -0,0 +1,46 @@
+const https = require('https');
+const { URL } = require('url');
+
+const BASE_URL = 'https://api.mayar.id';
+const VERSION = require('../package.json').version;
+
+function request(method, pathname, { apiKey, body, query } = {}) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(BASE_URL + pathname);
+    if (query) {
+      for (const [k, v] of Object.entries(query)) {
+        if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, v);
+      }
+    }
+    const data = body ? Buffer.from(JSON.stringify(body)) : null;
+    const opts = {
+      method,
+      hostname: url.hostname,
+      path: url.pathname + url.search,
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        Accept: 'application/json',
+        'User-Agent': `mayar-cli/${VERSION}`,
+      },
+    };
+    if (data) {
+      opts.headers['Content-Type'] = 'application/json';
+      opts.headers['Content-Length'] = data.length;
+    }
+    const req = https.request(opts, (res) => {
+      const chunks = [];
+      res.on('data', (c) => chunks.push(c));
+      res.on('end', () => {
+        const text = Buffer.concat(chunks).toString('utf8');
+        let parsed;
+        try { parsed = text ? JSON.parse(text) : null; } catch (_) { parsed = text; }
+        resolve({ status: res.statusCode, body: parsed, raw: text });
+      });
+    });
+    req.on('error', reject);
+    if (data) req.write(data);
+    req.end();
+  });
+}
+
+module.exports = { request, BASE_URL };

package/src/cli.js

@@ -0,0 +1,176 @@
+const ui = require('./ui');
+const config = require('./config');
+
+const VERSION = require('../package.json').version;
+
+const HELP = () => `${ui.bold('mayar')} ${ui.dim('— Mayar API CLI (production)')}
+
+${ui.bold('Usage:')}
+  mayar <command> [args] [flags]
+
+${ui.bold('Setup:')}
+  init                                Run first-time setup (or re-configure API key)
+  config show                         Show config path and masked API key
+  config reset                        Remove the saved API key
+
+${ui.bold('Account:')}
+  balance                             Get account balance
+
+${ui.bold('Invoices:')}
+  invoice list [--page N --pageSize N]
+  invoice get <id>
+  invoice close <id>
+  invoice reopen <id>
+  invoice create --data <json|@file.json>
+
+${ui.bold('Products:')}
+  product list [--page N --pageSize N]
+  product search <keyword>
+  product type <ebook|course|membership|saas|event|webinar|...>
+  product get <id>
+  product close <id>
+  product reopen <id>
+
+${ui.bold('Single payment requests:')}
+  payment list
+  payment get <id>
+  payment close <id>
+  payment reopen <id>
+  payment create --data <json|@file.json>
+
+${ui.bold('Customers:')}
+  customer list [--page N --pageSize N]
+  customer create --data <json|@file.json>
+
+${ui.bold('Transactions:')}
+  tx list [--page N --pageSize N]     Paid transactions
+  tx unpaid [--page N --pageSize N]   Unpaid transactions
+
+${ui.bold('Dynamic QR:')}
+  qrcode <amount>
+
+${ui.bold('Webhooks:')}
+  webhook register <url>
+  webhook test <url>
+  webhook history [--page N --pageSize N]
+
+${ui.bold('Global flags:')}
+  --json                Output raw JSON instead of formatted tables
+  --api-key <key>       Override saved API key for this run
+  --page N              Pagination page (default 1)
+  --pageSize N          Pagination page size (default 10)
+  -h, --help            Show help
+  -v, --version         Show version
+
+${ui.dim('Endpoint: https://api.mayar.id (production only)')}
+${ui.dim('Config:   ~/.mayar/config.json (chmod 600)')}
+`;
+
+function parseFlags(argv) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--') { positional.push(...argv.slice(i + 1)); break; }
+    if (a === '--json') flags.json = true;
+    else if (a === '--force') flags.force = true;
+    else if (a === '--api-key') flags.apiKey = argv[++i];
+    else if (a === '--page') flags.page = argv[++i];
+    else if (a === '--pageSize' || a === '--page-size') flags.pageSize = argv[++i];
+    else if (a === '--data') flags.data = argv[++i];
+    else if (a === '-h' || a === '--help') flags.help = true;
+    else if (a === '-v' || a === '--version') flags.version = true;
+    else if (a.startsWith('--')) {
+      const eq = a.indexOf('=');
+      if (eq !== -1) flags[a.slice(2, eq)] = a.slice(eq + 1);
+      else flags[a.slice(2)] = argv[++i];
+    } else {
+      positional.push(a);
+    }
+  }
+  return { flags, positional };
+}
+
+async function ensureKey(flags) {
+  if (flags.apiKey) return flags.apiKey;
+  const cfg = config.load();
+  if (cfg && cfg.apiKey) return cfg.apiKey;
+  // First-run flow
+  ui.printBanner();
+  process.stdout.write(`${ui.bold('Welcome to Mayar CLI.')}\n`);
+  process.stdout.write(`No API key found. Get yours from ${ui.cyan('https://web.mayar.id')} → Integration → API Key.\n\n`);
+  if (!process.stdin.isTTY) {
+    process.stderr.write(ui.red('Stdin is not a TTY — cannot prompt. Run `mayar init` interactively or pass --api-key.\n'));
+    process.exit(1);
+  }
+  const key = await ui.askSecret(ui.bold('Paste your production API key: '));
+  if (!key.trim()) { process.stderr.write(ui.red('No key provided. Aborting.\n')); process.exit(1); }
+  config.save({ apiKey: key.trim(), endpoint: 'production', savedAt: new Date().toISOString() });
+  process.stdout.write(ui.green(`✓ Saved to ${config.file}`) + '\n\n');
+  return key.trim();
+}
+
+async function run(argv) {
+  const { flags, positional } = parseFlags(argv);
+
+  if (flags.version) { process.stdout.write(VERSION + '\n'); return; }
+  if (!positional.length || (flags.help && !positional.length)) { process.stdout.write(HELP()); return; }
+
+  const [cmd, sub, ...rest] = positional;
+
+  try {
+    if (cmd === 'help') { process.stdout.write(HELP()); return; }
+    if (cmd === 'init') {
+      const init = require('./commands/init');
+      return await init.run({ flags });
+    }
+    if (cmd === 'config') {
+      if (sub === 'show') {
+        const cfg = config.load();
+        if (!cfg) { process.stdout.write(ui.dim('(no config saved)') + '\n'); return; }
+        const masked = cfg.apiKey ? cfg.apiKey.slice(0, 6) + '…' + cfg.apiKey.slice(-4) : '(none)';
+        process.stdout.write(`Path:     ${config.file}\n`);
+        process.stdout.write(`API Key:  ${masked}\n`);
+        process.stdout.write(`Endpoint: ${cfg.endpoint || 'production'}\n`);
+        process.stdout.write(`Saved at: ${cfg.savedAt || ''}\n`);
+        return;
+      }
+      if (sub === 'reset') {
+        const ok = config.clear();
+        process.stdout.write((ok ? ui.green('✓ Config cleared.') : ui.dim('(no config to clear)')) + '\n');
+        return;
+      }
+      process.stdout.write('Usage: mayar config <show|reset>\n');
+      return;
+    }
+
+    const handlers = {
+      balance:      './commands/balance',
+      invoice:      './commands/invoice',
+      product:      './commands/product',
+      payment:      './commands/payment',
+      customer:     './commands/customer',
+      tx:           './commands/transaction',
+      transaction:  './commands/transaction',
+      transactions: './commands/transaction',
+      qr:           './commands/qrcode',
+      qrcode:       './commands/qrcode',
+      webhook:      './commands/webhook',
+    };
+    const handler = handlers[cmd];
+    if (!handler) {
+      process.stderr.write(ui.red(`Unknown command: ${cmd}`) + '\n\n');
+      process.stdout.write(HELP());
+      process.exit(1);
+    }
+
+    const apiKey = await ensureKey(flags);
+    const ctx = { apiKey, flags, positional: [sub, ...rest].filter((x) => x !== undefined) };
+    return await require(handler).run(ctx);
+  } catch (err) {
+    process.stderr.write(ui.red('Error: ' + (err.message || String(err))) + '\n');
+    process.exit(1);
+  }
+}
+
+module.exports = { run };

package/src/commands/balance.js

@@ -0,0 +1,16 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+async function run({ apiKey, flags }) {
+  const res = await api.request('GET', '/hl/v1/balance', { apiKey });
+  checkResp(res);
+  if (flags.json) return ui.jsonOut(res.body);
+  const d = (res.body && res.body.data) || {};
+  if (!Object.keys(d).length) return ui.jsonOut(res.body);
+  const fmt = (n) => (typeof n === 'number' ? n.toLocaleString('id-ID') : String(n ?? '?'));
+  const rows = Object.entries(d).map(([k, v]) => ({ field: k, value: fmt(v) }));
+  ui.table(rows, ['field', 'value']);
+}
+
+module.exports = { run };

package/src/commands/customer.js

@@ -0,0 +1,34 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData } = require('../util');
+
+const USAGE = 'Usage: mayar customer <list|create>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub] = positional;
+  switch (sub) {
+    case 'list': {
+      const res = await api.request('GET', '/hl/v1/customer', {
+        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((c) => ({
+        id: c.id, name: c.name, email: c.email, mobile: c.mobile, status: c.status,
+      }));
+      ui.table(rows, ['id', 'name', 'email', 'mobile', 'status']);
+      return;
+    }
+    case 'create': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar customer create requires --data \'{"name":"...","email":"...","mobile":"..."}\'');
+      const res = await api.request('POST', '/hl/v1/customer/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/init.js

@@ -0,0 +1,25 @@
+const config = require('../config');
+const ui = require('../ui');
+
+async function run({ flags }) {
+  ui.printBanner();
+  const existing = config.load();
+  if (existing && existing.apiKey && !flags.force) {
+    const masked = existing.apiKey.slice(0, 6) + '…' + existing.apiKey.slice(-4);
+    process.stdout.write(ui.dim(`A key is already configured (${masked}).`) + '\n');
+    const ans = await ui.ask('Overwrite? [y/N] ');
+    if (!/^y/i.test(ans.trim())) { process.stdout.write('Cancelled.\n'); return; }
+  }
+  process.stdout.write(`${ui.bold('Welcome to Mayar CLI.')}\n`);
+  process.stdout.write(`Get your key from ${ui.cyan('https://web.mayar.id')} → Integration → API Key.\n\n`);
+  const key = await ui.askSecret(ui.bold('Paste your production API key: '));
+  if (!key.trim()) { process.stderr.write(ui.red('No key provided.\n')); process.exit(1); }
+  config.save({ apiKey: key.trim(), endpoint: 'production', savedAt: new Date().toISOString() });
+  process.stdout.write(ui.green(`✓ Saved to ${config.file}`) + '\n\n');
+  process.stdout.write('Try:\n');
+  process.stdout.write('  mayar balance\n');
+  process.stdout.write('  mayar invoice list\n');
+  process.stdout.write('  mayar product list\n');
+}
+
+module.exports = { run };

package/src/commands/invoice.js

@@ -0,0 +1,55 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData } = require('../util');
+
+const USAGE = 'Usage: mayar invoice <list|get|close|reopen|create>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case 'list': {
+      const res = await api.request('GET', '/hl/v1/invoice', {
+        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((i) => ({
+        id: i.id,
+        customer: (i.customer && (i.customer.name || i.customer.email)) || '',
+        amount: i.amount,
+        status: i.status,
+        createdAt: i.createdAt,
+      }));
+      ui.table(rows, ['id', 'customer', 'amount', 'status', 'createdAt']);
+      const m = res.body || {};
+      process.stdout.write(ui.dim(`page ${m.page ?? '?'} / ${m.pageCount ?? '?'} · total ${m.total ?? data.length}`) + '\n');
+      return;
+    }
+    case 'get': {
+      if (!rest[0]) throw new Error('Usage: mayar invoice get <id>');
+      const res = await api.request('GET', `/hl/v1/invoice/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'close': {
+      if (!rest[0]) throw new Error('Usage: mayar invoice close <id>');
+      const res = await api.request('GET', `/hl/v1/invoice/close/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'reopen': {
+      if (!rest[0]) throw new Error('Usage: mayar invoice reopen <id>');
+      const res = await api.request('GET', `/hl/v1/invoice/open/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'create': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar invoice create requires --data <json|@file.json>');
+      const res = await api.request('POST', '/hl/v1/invoice/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/payment.js

@@ -0,0 +1,49 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData } = require('../util');
+
+const USAGE = 'Usage: mayar payment <list|get|close|reopen|create>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case 'list': {
+      const res = await api.request('GET', '/hl/v1/payment', {
+        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((p) => ({
+        id: p.id, name: p.name, amount: p.amount, status: p.status, createdAt: p.createdAt,
+      }));
+      ui.table(rows, ['id', 'name', 'amount', 'status', 'createdAt']);
+      return;
+    }
+    case 'get': {
+      if (!rest[0]) throw new Error('Usage: mayar payment get <id>');
+      const res = await api.request('GET', `/hl/v1/payment/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'close': {
+      if (!rest[0]) throw new Error('Usage: mayar payment close <id>');
+      const res = await api.request('GET', `/hl/v1/payment/close/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'reopen': {
+      if (!rest[0]) throw new Error('Usage: mayar payment reopen <id>');
+      const res = await api.request('GET', `/hl/v1/payment/open/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'create': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar payment create requires --data <json|@file.json>');
+      const res = await api.request('POST', '/hl/v1/payment/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/product.js

@@ -0,0 +1,73 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+const USAGE = 'Usage: mayar product <list|get|close|reopen|search|type>';
+
+function renderList(body) {
+  const data = (body && body.data) || [];
+  const rows = data.map((p) => ({
+    id: p.id,
+    name: p.name,
+    type: p.type,
+    amount: p.amount,
+    status: p.status,
+    productLink: p.linkUrl || '',
+    checkoutLink: p.linkPayment || '',
+  }));
+  ui.table(rows, ['id', 'name', 'type', 'amount', 'status', 'productLink', 'checkoutLink']);
+  const m = body || {};
+  process.stdout.write(ui.dim(`page ${m.page ?? '?'} / ${m.pageCount ?? '?'} · total ${m.total ?? data.length}`) + '\n');
+}
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case 'list': {
+      const res = await api.request('GET', '/hl/v1/product', {
+        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderList(res.body); return;
+    }
+    case 'search': {
+      if (!rest[0]) throw new Error('Usage: mayar product search <keyword>');
+      const search = rest.join(' ');
+      const res = await api.request('GET', '/hl/v1/product', {
+        apiKey, query: { search, page: flags.page, pageSize: flags.pageSize },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderList(res.body); return;
+    }
+    case 'type': {
+      if (!rest[0]) throw new Error('Usage: mayar product type <ebook|course|membership|saas|event|webinar|...>');
+      const res = await api.request('GET', `/hl/v1/product/type/${encodeURIComponent(rest[0])}`, {
+        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderList(res.body); return;
+    }
+    case 'get': {
+      if (!rest[0]) throw new Error('Usage: mayar product get <id>');
+      const res = await api.request('GET', `/hl/v1/product/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'close': {
+      if (!rest[0]) throw new Error('Usage: mayar product close <id>');
+      const res = await api.request('GET', `/hl/v1/product/close/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'reopen': {
+      if (!rest[0]) throw new Error('Usage: mayar product reopen <id>');
+      const res = await api.request('GET', `/hl/v1/product/open/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/qrcode.js

@@ -0,0 +1,19 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+async function run({ apiKey, flags, positional }) {
+  const [amountArg] = positional;
+  if (!amountArg) throw new Error('Usage: mayar qrcode <amount>');
+  const amount = Number(amountArg);
+  if (!Number.isFinite(amount) || amount <= 0) throw new Error('Amount must be a positive number.');
+  const res = await api.request('POST', '/hl/v1/qrcode/create', { apiKey, body: { amount } });
+  checkResp(res);
+  if (flags.json) return ui.jsonOut(res.body);
+  const d = (res.body && res.body.data) || {};
+  process.stdout.write(`${ui.bold('QR amount:')} ${d.amount ?? amount}\n`);
+  if (d.url) process.stdout.write(`${ui.bold('QR image:')}  ${ui.cyan(d.url)}\n`);
+  else ui.jsonOut(res.body);
+}
+
+module.exports = { run };

package/src/commands/transaction.js

@@ -0,0 +1,45 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+const USAGE = 'Usage: mayar tx <list|unpaid>';
+
+function renderTx(body) {
+  const data = (body && body.data) || [];
+  const rows = data.map((t) => ({
+    id: t.id,
+    customer: (t.customer && (t.customer.name || t.customer.email)) || t.customerName || '',
+    amount: t.amount,
+    status: t.status,
+    createdAt: t.createdAt,
+  }));
+  ui.table(rows, ['id', 'customer', 'amount', 'status', 'createdAt']);
+}
+
+async function run({ apiKey, flags, positional }) {
+  const [sub] = positional;
+  switch (sub) {
+    case undefined:
+    case 'list':
+    case 'paid': {
+      const res = await api.request('GET', '/hl/v1/transactions', {
+        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderTx(res.body); return;
+    }
+    case 'unpaid': {
+      const res = await api.request('GET', '/hl/v1/transactions/unpaid', {
+        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderTx(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/webhook.js

@@ -0,0 +1,43 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+const USAGE = 'Usage: mayar webhook <register|test|history>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case 'register': {
+      if (!rest[0]) throw new Error('Usage: mayar webhook register <url>');
+      const res = await api.request('GET', '/hl/v1/webhook/register', { apiKey, body: { urlHook: rest[0] } });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'test': {
+      if (!rest[0]) throw new Error('Usage: mayar webhook test <url>');
+      const res = await api.request('POST', '/hl/v1/webhook/test', { apiKey, body: { urlHook: rest[0] } });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'history': {
+      const res = await api.request('GET', '/hl/v1/webhook/history', {
+        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((w) => ({
+        id: w.id, type: w.type, status: w.status, urlDestination: w.urlDestination, createdAt: w.createdAt,
+      }));
+      ui.table(rows, ['id', 'type', 'status', 'urlDestination', 'createdAt']);
+      return;
+    }
+    case 'retry': {
+      if (!rest[0]) throw new Error('Usage: mayar webhook retry <historyId>');
+      const res = await api.request('GET', `/hl/v1/webhook/history/retry/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/config.js

@@ -0,0 +1,26 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const dir = path.join(os.homedir(), '.mayar');
+const file = path.join(dir, 'config.json');
+
+function load() {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch (_) {
+    return null;
+  }
+}
+
+function save(data) {
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  try { fs.chmodSync(file, 0o600); } catch (_) {}
+}
+
+function clear() {
+  try { fs.unlinkSync(file); return true; } catch (_) { return false; }
+}
+
+module.exports = { load, save, clear, file, dir };

package/src/ui.js

@@ -0,0 +1,104 @@
+const readline = require('readline');
+
+const isTTY = !!process.stdout.isTTY;
+const wrap = (n) => (s) => isTTY ? `\x1b[${n}m${s}\x1b[0m` : String(s);
+const dim = wrap('2');
+const bold = wrap('1');
+const red = wrap('31');
+const green = wrap('32');
+const yellow = wrap('33');
+const cyan = wrap('36');
+const magenta = wrap('35');
+
+const BANNER = `\x1b[35m
+███╗   ███╗ █████╗ ██╗   ██╗ █████╗ ██████╗
+████╗ ████║██╔══██╗╚██╗ ██╔╝██╔══██╗██╔══██╗
+██╔████╔██║███████║ ╚████╔╝ ███████║██████╔╝
+██║╚██╔╝██║██╔══██║  ╚██╔╝  ██╔══██║██╔══██╗
+██║ ╚═╝ ██║██║  ██║   ██║   ██║  ██║██║  ██║
+╚═╝     ╚═╝╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝\x1b[0m
+\x1b[36m         command line interface · production\x1b[0m
+`;
+
+function printBanner() {
+  if (isTTY) process.stdout.write(BANNER + '\n');
+  else process.stdout.write('Mayar CLI\n\n');
+}
+
+function ask(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => { rl.close(); resolve(answer); });
+  });
+}
+
+function askSecret(question) {
+  return new Promise((resolve) => {
+    process.stdout.write(question);
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw === true;
+    stdin.resume();
+    stdin.setEncoding('utf8');
+    if (stdin.setRawMode) stdin.setRawMode(true);
+    let buf = '';
+    const cleanup = () => {
+      stdin.removeListener('data', onData);
+      if (stdin.setRawMode) stdin.setRawMode(wasRaw);
+      stdin.pause();
+    };
+    const onData = (key) => {
+      if (key === '') {
+        cleanup();
+        process.stdout.write('\n');
+        process.exit(130);
+      }
+      if (key === '\r' || key === '\n') {
+        cleanup();
+        process.stdout.write('\n');
+        resolve(buf);
+        return;
+      }
+      if (key === '' || key === '\b') {
+        if (buf.length > 0) {
+          buf = buf.slice(0, -1);
+          process.stdout.write('\b \b');
+        }
+        return;
+      }
+      if (key.charCodeAt(0) < 32) return;
+      buf += key;
+      process.stdout.write('*');
+    };
+    stdin.on('data', onData);
+  });
+}
+
+function jsonOut(obj) {
+  process.stdout.write(JSON.stringify(obj, null, 2) + '\n');
+}
+
+function table(rows, columns) {
+  if (!rows || !rows.length) {
+    process.stdout.write(dim('(no rows)') + '\n');
+    return;
+  }
+  const widths = columns.map((col) =>
+    Math.min(48, Math.max(col.length, ...rows.map((r) => String(r[col] ?? '').length))),
+  );
+  const head = columns.map((col, i) => bold(col.padEnd(widths[i]))).join('  ');
+  process.stdout.write(head + '\n');
+  process.stdout.write(columns.map((_, i) => dim('─'.repeat(widths[i]))).join('  ') + '\n');
+  for (const r of rows) {
+    const line = columns.map((col, i) => {
+      let v = String(r[col] ?? '');
+      if (v.length > widths[i]) v = v.slice(0, widths[i] - 1) + '…';
+      return v.padEnd(widths[i]);
+    }).join('  ');
+    process.stdout.write(line + '\n');
+  }
+}
+
+module.exports = {
+  printBanner, ask, askSecret, jsonOut, table,
+  dim, bold, red, green, yellow, cyan, magenta,
+};

package/src/util.js

@@ -0,0 +1,34 @@
+const fs = require('fs');
+const ui = require('./ui');
+
+function checkResp(res) {
+  if (res.status >= 200 && res.status < 300) return;
+  const msg = (res.body && (res.body.messages || res.body.message)) || res.raw || '';
+  const err = new Error(`API ${res.status} — ${msg}`);
+  err.status = res.status;
+  err.body = res.body;
+  throw err;
+}
+
+function readData(value) {
+  if (!value) return undefined;
+  if (value.startsWith('@')) {
+    const content = fs.readFileSync(value.slice(1), 'utf8');
+    return JSON.parse(content);
+  }
+  return JSON.parse(value);
+}
+
+function maybeJson(flags, body, fallback) {
+  if (flags.json) {
+    ui.jsonOut(body);
+    return true;
+  }
+  if (typeof fallback === 'function') {
+    fallback();
+    return true;
+  }
+  return false;
+}
+
+module.exports = { checkResp, readData, maybeJson };