mayar 0.2.0 → 1.0.1

package/src/commands/review.js

@@ -1,8 +1,8 @@
 const api = require('../api');
 const ui = require('../ui');
-const { checkResp } = require('../util');
+const { checkResp, readData, pagination, cursorFooter } = require('../util');
 
-const USAGE = 'Usage: mayar review <list>';
+const USAGE = 'Usage: mayar review <list|stats|create|update|bulk-status|product|product-customer>';
 
 function fmtDate(v) {
   if (v == null) return '';
@@ -10,29 +10,101 @@ function fmtDate(v) {
   return String(v);
 }
 
+function renderList(body) {
+  const data = (body && 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']);
+  cursorFooter(body, data.length);
+}
+
+function renderStats(body) {
+  const d = (body && body.data) || {};
+  process.stdout.write(`${ui.bold('Total reviews:')}  ${d.total ?? 0}\n`);
+  process.stdout.write(`${ui.bold('Average rating:')} ${d.average ?? '—'}\n`);
+  if (Array.isArray(d.stats) && d.stats.length) {
+    process.stdout.write('\n');
+    ui.table(
+      d.stats.map((s) => ({
+        rating: s.rating,
+        totalRating: s.totalRating,
+        percentage: typeof s.percentage === 'number' ? `${s.percentage}%` : String(s.percentage ?? ''),
+      })),
+      ['rating', 'totalRating', 'percentage'],
+    );
+  }
+}
+
 async function run({ apiKey, flags, positional }) {
-  const [sub] = positional;
+  const [sub, ...rest] = positional;
   switch (sub) {
     case undefined:
     case 'list': {
-      const res = await api.request('GET', '/hl/v1/reviews', {
-        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
+      const res = await api.request('GET', '/hl/v2/reviews', {
+        apiKey,
+        query: pagination(flags, {
+          status: flags.status, paymentLinkId: flags.paymentLinkId, rating: flags.rating,
+        }),
       });
       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;
+      renderList(res.body); return;
+    }
+    case 'stats': {
+      const productId = rest[0];
+      const path = productId
+        ? `/hl/v2/products/${encodeURIComponent(productId)}/reviews/stats`
+        : '/hl/v2/merchants/reviews/stats';
+      const res = await api.request('GET', path, { apiKey });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderStats(res.body); return;
+    }
+    case 'create': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar review create requires --data <json|@file> ({paymentLinkId,customerEmail,rating})');
+      const res = await api.request('POST', '/hl/v2/reviews/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'update': {
+      if (!rest[0]) throw new Error('Usage: mayar review update <id> --data <json|@file>');
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar review update requires --data <json|@file>');
+      body.id = body.id || rest[0];
+      const res = await api.request('POST', `/hl/v2/reviews/${encodeURIComponent(rest[0])}/update`, { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'bulk-status':
+    case 'bulkstatus': {
+      const data = readData(flags.data);
+      if (!data) throw new Error('mayar review bulk-status requires --data <json|@file> (array of {id,status})');
+      const body = Array.isArray(data) ? { input: data } : data;
+      const res = await api.request('POST', '/hl/v2/reviews/bulk-status/update', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'product': {
+      if (!rest[0]) throw new Error('Usage: mayar review product <paymentLinkId>');
+      const res = await api.request('GET', `/hl/v2/products/${encodeURIComponent(rest[0])}/reviews`, {
+        apiKey, query: pagination(flags, { rating: flags.rating, prioritizeMessage: flags.prioritizeMessage }),
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderList(res.body); return;
+    }
+    case 'product-customer':
+    case 'productcustomer': {
+      if (!rest[0]) throw new Error('Usage: mayar review product-customer <paymentLinkId> --customerId <id>');
+      if (!flags.customerId) throw new Error('mayar review product-customer requires --customerId <id>');
+      const res = await api.request('GET', `/hl/v2/products/${encodeURIComponent(rest[0])}/reviews/customer`, {
+        apiKey, query: { customerId: flags.customerId },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
     }
     default:
       throw new Error(USAGE);

package/src/commands/saas.js

@@ -0,0 +1,18 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+const USAGE = 'Usage: mayar saas <activate|deactivate|verify> <licenseCode> <productId>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, licenseCode, productId] = positional;
+  if (!['activate', 'deactivate', 'verify'].includes(sub)) throw new Error(USAGE);
+  if (!licenseCode || !productId) throw new Error(USAGE);
+  // SaaS licensing lives under /saas/v2/license/* — NOT /hl/v2.
+  const res = await api.request('POST', `/saas/v2/license/${sub}`, {
+    apiKey, body: { licenseCode, productId },
+  });
+  checkResp(res); ui.jsonOut(res.body);
+}
+
+module.exports = { run };

package/src/commands/software.js

@@ -0,0 +1,17 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp } = require('../util');
+
+const USAGE = 'Usage: mayar software verify <licenseCode> <productId>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, licenseCode, productId] = positional;
+  if (sub !== 'verify') throw new Error(USAGE);
+  if (!licenseCode || !productId) throw new Error(USAGE);
+  const res = await api.request('POST', '/software/v2/license/verify', {
+    apiKey, body: { licenseCode, productId },
+  });
+  checkResp(res); ui.jsonOut(res.body);
+}
+
+module.exports = { run };

package/src/commands/transaction.js

@@ -1,8 +1,8 @@
 const api = require('../api');
 const ui = require('../ui');
-const { checkResp } = require('../util');
+const { checkResp, pagination, cursorFooter } = require('../util');
 
-const USAGE = 'Usage: mayar tx <list|unpaid|daily>';
+const USAGE = 'Usage: mayar tx <list|unpaid|daily|product>';
 
 function fmtDate(v) {
   if (v == null) return '';
@@ -22,40 +22,67 @@ function renderTx(body) {
     createdAt: fmtDate(t.createdAt),
   }));
   ui.table(rows, ['id', 'customer', 'amount', 'status', 'createdAt']);
+  cursorFooter(body, data.length);
 }
 
 async function run({ apiKey, flags, positional }) {
-  const [sub] = positional;
+  const [sub, ...rest] = 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 },
+      const res = await api.request('GET', '/hl/v2/transactions', {
+        apiKey,
+        query: pagination(flags, {
+          status: flags.status,
+          customerId: flags.customerId,
+          type: flags.type,
+          paymentLinkId: flags.paymentLinkId,
+          startAt: flags.startAt,
+          endAt: flags.endAt,
+          fields: flags.fields,
+        }),
       });
       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 },
+      const res = await api.request('GET', '/hl/v2/transactions/unpaid', {
+        apiKey,
+        query: pagination(flags, {
+          status: flags.status,
+          customerId: flags.customerId,
+          paymentLinkId: flags.paymentLinkId,
+          startAt: flags.startAt,
+          endAt: flags.endAt,
+          fields: flags.fields,
+        }),
       });
       checkResp(res);
       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 });
+      const res = await api.request('GET', '/hl/v2/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);
+      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 == null && d.trxCount == null) ui.jsonOut(res.body);
       return;
     }
+    case 'product': {
+      if (!rest[0]) throw new Error('Usage: mayar tx product <productId>');
+      const res = await api.request('GET', `/hl/v2/products/${encodeURIComponent(rest[0])}/transactions`, {
+        apiKey, query: pagination(flags, { status: flags.status, customerId: flags.customerId, fields: flags.fields }),
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderTx(res.body); return;
+    }
     default:
       throw new Error(USAGE);
   }

package/src/commands/webhook.js

@@ -1,38 +1,71 @@
 const api = require('../api');
 const ui = require('../ui');
-const { checkResp } = require('../util');
+const { checkResp, pagination, cursorFooter } = require('../util');
 
-const USAGE = 'Usage: mayar webhook <register|test|history>';
+const USAGE = 'Usage: mayar webhook <register|test|history|new-history|retry>';
+
+function fmtDate(v) {
+  if (v == null) return '';
+  if (typeof v === 'number') return new Date(v).toISOString();
+  return String(v);
+}
+
+function renderHistory(body) {
+  const data = (body && body.data) || [];
+  const rows = data.map((w) => ({
+    id: w.id, type: w.type, status: w.status,
+    urlDestination: w.urlDestination || '',
+    createdAt: fmtDate(w.createdAt),
+  }));
+  ui.table(rows, ['id', 'type', 'status', 'urlDestination', 'createdAt']);
+  cursorFooter(body, data.length);
+}
 
 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] } });
+      // v2: register is now POST /webhooks/update
+      const res = await api.request('POST', '/hl/v2/webhooks/update', {
+        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] } });
+      const res = await api.request('POST', '/hl/v2/webhooks/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 },
+      const res = await api.request('GET', '/hl/v2/webhooks/history', {
+        apiKey,
+        query: pagination(flags, {
+          status: flags.status, type: flags.type,
+          urlDestination: flags.urlDestination,
+          startAt: flags.startAt, endAt: flags.endAt,
+        }),
       });
       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;
+      renderHistory(res.body); return;
+    }
+    case 'new-history':
+    case 'newhistory': {
+      const res = await api.request('GET', '/hl/v2/webhooks/new-history', {
+        apiKey, query: pagination(flags),
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderHistory(res.body); 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 });
+      const res = await api.request('POST', '/hl/v2/webhooks/retry', {
+        apiKey, body: { webhookHistoryId: rest[0] },
+      });
       checkResp(res); ui.jsonOut(res.body); return;
     }
     default:

package/src/util.js

@@ -19,6 +19,33 @@ function readData(value) {
   return JSON.parse(value);
 }
 
+// Build a v2 cursor pagination query from flags.
+// v2 uses limit + startingAfter. --pageSize is accepted as an alias for --limit,
+// --after is the short form of --starting-after.
+function pagination(flags, extra) {
+  const q = { ...(extra || {}) };
+  const limit = flags.limit ?? flags.pageSize;
+  const after = flags.after ?? flags.startingAfter ?? flags['starting-after'];
+  if (limit !== undefined && limit !== '') q.limit = limit;
+  if (after !== undefined && after !== '') q.startingAfter = after;
+  return q;
+}
+
+// Print the cursor footer after a paginated list. Mayar v2 returns
+// nextStartingAfter + hasMore on the response envelope.
+function cursorFooter(body, count) {
+  const m = body || {};
+  const parts = [];
+  if (typeof m.pageSize === 'number' || typeof m.limit === 'number') {
+    parts.push(`limit ${m.pageSize ?? m.limit}`);
+  }
+  if (typeof count === 'number') parts.push(`showing ${count}`);
+  if (m.nextStartingAfter) parts.push(`next: --after ${m.nextStartingAfter}`);
+  if (m.hasMore === true) parts.push('hasMore');
+  if (!parts.length) return;
+  process.stdout.write(ui.dim(parts.join(' · ')) + '\n');
+}
+
 function maybeJson(flags, body, fallback) {
   if (flags.json) {
     ui.jsonOut(body);
@@ -31,4 +58,4 @@ function maybeJson(flags, body, fallback) {
   return false;
 }
 
-module.exports = { checkResp, readData, maybeJson };
+module.exports = { checkResp, readData, maybeJson, pagination, cursorFooter };

package/node_modules/@mayaross/auth/README.md

@@ -1,204 +0,0 @@
-# @mayaross/auth
-
-SDK untuk autentikasi `mayar-cli` via mayar auth service menggunakan Google OAuth + SSE.
-
-## Instalasi
-
-```bash
-npm install @mayaross/auth
-```
-
-Tidak ada dependency eksternal — hanya menggunakan built-in Node.js (`https`, `http`, `child_process`). Membutuhkan Node.js >= 18.
-
----
-
-## Flow
-
-```
-mayar login
-    │
-    ├─ 1. Minta appid + URL ke server  →  GET /token/cli/initiate
-    │
-    ├─ 2. Buka browser ke auth URL     →  /oauth2/google?state=appid,<uuid>
-    │
-    ├─ 3. Subscribe SSE                →  GET /token/cli/stream?appid=<uuid>
-    │         (tunggu token, max 5 menit)
-    │
-    ├─ 4. User login Google di browser
-    │
-    └─ 5. Server push token via SSE   →  CLI terima, simpan credentials
-```
-
----
-
-## Penggunaan
-
-### Login satu langkah
-
-```js
-const { MayarAuth } = require('@mayaross/auth');
-
-const auth = new MayarAuth('https://auth.mayar.id');
-
-try {
-  const token = await auth.login({
-    onUrl: ({ url }) => {
-      console.log(`Membuka browser untuk login...`);
-      console.log(`Jika browser tidak terbuka, buka URL ini:\n${url}`);
-    }
-  });
-
-  // token = "authToken,refreshToken"
-  console.log('Login berhasil!');
-  // simpan token ke ~/.mayar/credentials atau keychain
-} catch (e) {
-  console.error('Login gagal:', e.message);
-}
-```
-
-### Manual step-by-step
-
-```js
-const { MayarAuth } = require('@mayaross/auth');
-
-const auth = new MayarAuth('https://auth.mayar.id');
-
-// 1. Dapatkan appid dan URL login
-const { appid, url } = await auth.initiate();
-console.log('Buka URL ini di browser:', url);
-
-// 2. (opsional) buka browser secara manual
-auth.openBrowser(url);
-
-// 3. Tunggu token via SSE
-const token = await auth.listenForToken(appid);
-console.log('Token diterima:', token);
-```
-
----
-
-## API
-
-### `new MayarAuth(baseUrl, opts?)`
-
-| Parameter | Type | Default | Keterangan |
-|-----------|------|---------|------------|
-| `baseUrl` | `string` | `'https://auth.mayar.id'` | Base URL auth server |
-| `opts.timeoutMs` | `number` | `300000` (5 menit) | Timeout tunggu login |
-
----
-
-### `auth.login(opts?)`
-
-Full login flow: initiate → buka browser → tunggu token via SSE.
-
-```ts
-login(opts?: {
-  openBrowser?: boolean,   // default: true. Set false untuk print URL saja
-  onUrl?: ({ appid, url }) => void  // callback sebelum browser dibuka
-}): Promise<string>  // "authToken,refreshToken"
-```
-
----
-
-### `auth.initiate()`
-
-Minta `appid` dan `url` dari server.
-
-```ts
-initiate(): Promise<{ appid: string, url: string }>
-```
-
----
-
-### `auth.listenForToken(appid)`
-
-Konek ke SSE stream dan tunggu token. Resolve saat token diterima, reject saat timeout.
-
-```ts
-listenForToken(appid: string): Promise<string>  // "authToken,refreshToken"
-```
-
----
-
-### `auth.openBrowser(url)`
-
-Buka URL di browser default. Support macOS, Linux, Windows.
-
-```ts
-openBrowser(url: string): void
-```
-
----
-
-## Format Token
-
-Token yang dikembalikan berupa string dengan format:
-
-```
-authToken,refreshToken
-```
-
-- **authToken** — JWT RS256, berlaku 24 jam
-- **refreshToken** — JWT RS256, berlaku 7 hari, digunakan untuk refresh otomatis via `/validate`
-
-Untuk decode payload:
-
-```js
-const [authToken] = token.split(',');
-const payload = JSON.parse(
-  Buffer.from(authToken.split('.')[1], 'base64url').toString()
-);
-// { sub: email, role, name, exp, ... }
-```
-
----
-
-## Contoh Integrasi di mayar-cli
-
-```js
-// commands/login.js
-const { MayarAuth } = require('@mayaross/auth');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const CREDENTIALS_PATH = path.join(os.homedir(), '.mayar', 'credentials.json');
-
-async function loginCommand() {
-  const auth = new MayarAuth(process.env.MAYAR_AUTH_URL || 'https://auth.mayar.id');
-
-  console.log('Menghubungkan ke mayar...');
-
-  const token = await auth.login({
-    onUrl: ({ url }) => {
-      console.log('\nJika browser tidak terbuka otomatis, buka URL ini:');
-      console.log(url + '\n');
-    }
-  });
-
-  const [authToken] = token.split(',');
-  const { sub: email, name, exp } = JSON.parse(
-    Buffer.from(authToken.split('.')[1], 'base64url').toString()
-  );
-
-  fs.mkdirSync(path.dirname(CREDENTIALS_PATH), { recursive: true });
-  fs.writeFileSync(CREDENTIALS_PATH, JSON.stringify({ token, email, name }, null, 2));
-
-  console.log(`\nLogin berhasil sebagai ${name} (${email})`);
-  console.log(`Token berlaku hingga ${new Date(exp * 1000).toLocaleString()}`);
-}
-
-module.exports = { loginCommand };
-```
-
----
-
-## Server Endpoints
-
-SDK ini mengonsumsi dua endpoint dari auth server:
-
-| Endpoint | Method | Keterangan |
-|----------|--------|------------|
-| `/token/cli/initiate` | GET | Generate `appid` + auth URL |
-| `/token/cli/stream?appid=<uuid>` | GET (SSE) | Stream token setelah user login |