mayar 0.1.9 → 1.0.1

package/src/commands/customer.js

@@ -8,9 +8,7 @@ async function run({ apiKey, flags, positional }) {
   const [sub, ...rest] = positional;
   switch (sub) {
     case 'list': {
-      const res = await api.request('GET', '/hl/v1/customer', {
-        apiKey, query: { page: flags.page, pageSize: flags.pageSize },
-      });
+      const res = await api.request('GET', '/hl/v2/customers', { apiKey });
       checkResp(res);
       if (flags.json) return ui.jsonOut(res.body);
       const data = (res.body && res.body.data) || [];
@@ -23,19 +21,19 @@ async function run({ apiKey, flags, positional }) {
     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 });
+      const res = await api.request('POST', '/hl/v2/customers/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', {
+      const res = await api.request('GET', '/hl/v2/customers/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', {
+      const res = await api.request('POST', '/hl/v2/customers/update', {
         apiKey, body: { fromEmail: rest[0], toEmail: rest[1] },
       });
       checkResp(res); ui.jsonOut(res.body); return;
@@ -43,7 +41,7 @@ async function run({ apiKey, flags, positional }) {
     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', {
+      const res = await api.request('POST', '/hl/v2/customers/portal-login', {
         apiKey, body: { email: rest[0] },
       });
       checkResp(res); ui.jsonOut(res.body); return;

package/src/commands/discount.js

@@ -0,0 +1,52 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData } = require('../util');
+
+const USAGE = 'Usage: mayar discount <create|get|validate|check>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case 'create': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar discount create requires --data <json|@file>');
+      const res = await api.request('POST', '/hl/v2/coupons/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'get':
+    case 'detail': {
+      if (!rest[0]) throw new Error('Usage: mayar discount get <id>');
+      const res = await api.request('GET', `/hl/v2/coupons/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'validate': {
+      if (!rest[0] || !rest[1]) throw new Error('Usage: mayar discount validate <couponCode> <paymentLinkId>');
+      const res = await api.request('POST', '/hl/v2/coupons/validate', {
+        apiKey, body: { couponCode: rest[0], paymentLinkId: rest[1] },
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      const d = (res.body && res.body.data) || {};
+      const c = d.coupon || {};
+      const valid = d.valid ? ui.green('✓ valid') : ui.red('✗ invalid');
+      process.stdout.write(`${ui.bold('Result:')}         ${valid}\n`);
+      if (c.code)          process.stdout.write(`${ui.bold('Code:')}           ${c.code}\n`);
+      if (c.discountType)  process.stdout.write(`${ui.bold('Discount type:')} ${c.discountType}\n`);
+      if (c.discountValue != null) process.stdout.write(`${ui.bold('Discount:')}       ${c.discountValue}${c.discountType === 'percentage' ? '%' : ''}\n`);
+      if (c.minimumPurchase != null) process.stdout.write(`${ui.bold('Min. purchase:')} ${c.minimumPurchase}\n`);
+      if (c.eligibleCustomerType) process.stdout.write(`${ui.bold('Eligible:')}       ${c.eligibleCustomerType}\n`);
+      return;
+    }
+    case 'check': {
+      if (!rest[0]) throw new Error('Usage: mayar discount check <couponCode>');
+      const res = await api.request('POST', '/hl/v2/coupons/check', {
+        apiKey, body: { couponCode: rest[0] },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/installment.js

@@ -0,0 +1,44 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData, pagination, cursorFooter } = require('../util');
+
+const USAGE = 'Usage: mayar installment <list|get|create>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case undefined:
+    case 'list': {
+      const res = await api.request('GET', '/hl/v2/installments', {
+        apiKey, query: pagination(flags, { status: flags.status, customerId: flags.customerId }),
+      });
+      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, name: i.name, email: i.email,
+        amount: i.amount, tenure: (i.installment && i.installment.tenure) || '',
+        status: i.status,
+      }));
+      ui.table(rows, ['id', 'name', 'email', 'amount', 'tenure', 'status']);
+      cursorFooter(res.body, data.length);
+      return;
+    }
+    case 'get':
+    case 'detail': {
+      if (!rest[0]) throw new Error('Usage: mayar installment get <id>');
+      const res = await api.request('GET', `/hl/v2/installments/${encodeURIComponent(rest[0])}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'create': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar installment create requires --data <json|@file>');
+      const res = await api.request('POST', '/hl/v2/installments/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/invoice.js

@@ -1,50 +1,78 @@
 const api = require('../api');
 const ui = require('../ui');
-const { checkResp, readData } = require('../util');
+const { checkResp, readData, pagination, cursorFooter } = require('../util');
 
-const USAGE = 'Usage: mayar invoice <list|get|close|reopen|create>';
+const USAGE = 'Usage: mayar invoice <list|get|close|reopen|status|edit|filter|create>';
+const STATUS_ACTIONS = ['open', 'close', 'active', 'closed', 'unlisted'];
+
+function renderList(body) {
+  const data = (body && 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: typeof i.createdAt === 'number' ? new Date(i.createdAt).toISOString() : (i.createdAt || ''),
+  }));
+  ui.table(rows, ['id', 'customer', 'amount', 'status', 'createdAt']);
+  cursorFooter(body, data.length);
+}
 
 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 },
+      const res = await api.request('GET', '/hl/v2/invoices', {
+        apiKey,
+        query: pagination(flags, { status: flags.status, search: flags.search }),
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      renderList(res.body); return;
+    }
+    case 'filter': {
+      if (!flags.email) throw new Error('mayar invoice filter requires --email <email>');
+      const res = await api.request('GET', '/hl/v2/invoices/filter', {
+        apiKey,
+        query: pagination(flags, { email: flags.email, status: flags.status, search: flags.search }),
       });
       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;
+      renderList(res.body); 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 });
+      const res = await api.request('GET', `/hl/v2/invoices/${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 });
+    case 'close':
+    case 'reopen': {
+      if (!rest[0]) throw new Error(`Usage: mayar invoice ${sub} <id>`);
+      const action = sub === 'reopen' ? 'open' : 'close';
+      // v2 consolidates status changes under a single action endpoint.
+      const res = await api.request('POST', `/hl/v2/invoices/${encodeURIComponent(rest[0])}/${action}`, { 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 });
+    case 'status': {
+      if (!rest[0] || !rest[1]) throw new Error(`Usage: mayar invoice status <id> <${STATUS_ACTIONS.join('|')}>`);
+      if (!STATUS_ACTIONS.includes(rest[1])) {
+        throw new Error(`Invalid action "${rest[1]}". Must be one of: ${STATUS_ACTIONS.join(', ')}`);
+      }
+      const res = await api.request('POST', `/hl/v2/invoices/${encodeURIComponent(rest[0])}/${rest[1]}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'edit': {
+      if (!rest[0]) throw new Error('Usage: mayar invoice edit <id> --data <json|@file>');
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar invoice edit requires --data <json|@file>');
+      body.id = body.id || rest[0];
+      const res = await api.request('POST', `/hl/v2/invoices/${encodeURIComponent(rest[0])}/update`, { apiKey, body });
       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 });
+      if (!body) throw new Error('mayar invoice create requires --data <json|@file>');
+      const res = await api.request('POST', '/hl/v2/invoices/create', { apiKey, body });
       checkResp(res); ui.jsonOut(res.body); return;
     }
     default:

package/src/commands/login.js

@@ -0,0 +1,74 @@
+const { MayarAuth } = require('@mayaross/auth');
+const config = require('../config');
+const ui = require('../ui');
+
+// Decode the payload of a JWT without verifying its signature.
+function decodeJwt(token) {
+  const parts = String(token || '').split('.');
+  if (parts.length !== 3) return null;
+  try {
+    const padded = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+    const pad = padded.length % 4 === 0 ? '' : '='.repeat(4 - (padded.length % 4));
+    return JSON.parse(Buffer.from(padded + pad, 'base64').toString('utf8'));
+  } catch (_) {
+    return null;
+  }
+}
+
+async function run({ flags }) {
+  const authUrl = config.authBaseUrl();
+  const auth = new MayarAuth(authUrl);
+
+  if (!flags.json) {
+    ui.printBanner();
+    process.stdout.write(`${ui.bold('Sign in to Mayar')}\n`);
+    process.stdout.write(`${ui.dim('Auth server:')} ${authUrl}\n\n`);
+    process.stdout.write('Opening your browser to complete Google sign-in…\n');
+  }
+
+  const token = await auth.login({
+    openBrowser: !flags['no-browser'],
+    onUrl: ({ url }) => {
+      if (flags.json) return;
+      if (flags['no-browser']) {
+        process.stdout.write('\nOpen this URL in your browser to sign in:\n');
+      } else {
+        process.stdout.write('\nIf your browser did not open automatically, visit:\n');
+      }
+      process.stdout.write(ui.cyan(url) + '\n\n');
+      process.stdout.write(ui.dim('Waiting for you to finish signing in…') + '\n');
+    },
+  });
+
+  // The SDK returns "authToken,refreshToken".
+  const [authToken, refreshToken] = String(token).split(',');
+  const claims = decodeJwt(authToken) || {};
+  const email = claims.sub || claims.email || null;
+  const name = claims.name || null;
+  const expiresAt = claims.exp ? new Date(claims.exp * 1000).toISOString() : null;
+
+  const existing = config.load() || {};
+  config.save({
+    ...existing,
+    auth: {
+      authToken,
+      refreshToken: refreshToken || null,
+      email,
+      name,
+      expiresAt,
+      authUrl,
+      savedAt: new Date().toISOString(),
+    },
+  });
+
+  if (flags.json) {
+    ui.jsonOut({ ok: true, email, name, expiresAt, authUrl });
+    return;
+  }
+
+  process.stdout.write('\n' + ui.green(`✓ Signed in${name ? ` as ${name}` : ''}${email ? ` (${email})` : ''}`) + '\n');
+  if (expiresAt) process.stdout.write(`${ui.bold('Token expires:')} ${expiresAt}\n`);
+  process.stdout.write(ui.dim(`Credentials saved to ${config.file}`) + '\n');
+}
+
+module.exports = { run };

package/src/commands/membership.js

@@ -0,0 +1,92 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData, pagination, cursorFooter } = require('../util');
+
+const USAGE = 'Usage: mayar membership <members|tiers|register|get|update|cancel|create-invoice>';
+
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  switch (sub) {
+    case 'members': {
+      if (!flags.productId) throw new Error('mayar membership members requires --productId <id>');
+      const res = await api.request('GET', '/hl/v2/memberships/members', {
+        apiKey, query: pagination(flags, { productId: flags.productId }),
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      const data = (res.body && res.body.data) || [];
+      const rows = data.map((m) => ({
+        id: m.id,
+        customer: (m.customer && (m.customer.name || m.customer.email)) || '',
+        tier: (m.membershipTier && m.membershipTier.name) || m.membershipTierId || '',
+        period: m.membershipMonthlyPeriod ?? '',
+        status: m.status || '',
+      }));
+      ui.table(rows, ['id', 'customer', 'tier', 'period', 'status']);
+      cursorFooter(res.body, data.length);
+      return;
+    }
+    case 'tiers': {
+      if (!flags.productId) throw new Error('mayar membership tiers requires --productId <id>');
+      const res = await api.request('GET', '/hl/v2/memberships/tiers', {
+        apiKey, query: pagination(flags, { productId: flags.productId }),
+      });
+      checkResp(res);
+      if (flags.json) return ui.jsonOut(res.body);
+      const data = (res.body && res.body.data) || [];
+      const rows = data.map((t) => ({
+        id: t.id, name: t.name, amount: t.amount, status: t.status,
+      }));
+      ui.table(rows, ['id', 'name', 'amount', 'status']);
+      cursorFooter(res.body, data.length);
+      return;
+    }
+    case 'register': {
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar membership register requires --data <json|@file>');
+      const res = await api.request('POST', '/hl/v2/memberships/members/create', { apiKey, body });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'get':
+    case 'detail': {
+      if (!rest[0]) throw new Error('Usage: mayar membership get <memberId> --productId <id>');
+      if (!flags.productId) throw new Error('mayar membership get requires --productId <id>');
+      const res = await api.request('GET', `/hl/v2/memberships/members/${encodeURIComponent(rest[0])}`, {
+        apiKey, query: { productId: flags.productId },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'update': {
+      if (!rest[0]) throw new Error('Usage: mayar membership update <memberId> --productId <id> [--data <json|@file>]');
+      if (!flags.productId) throw new Error('mayar membership update requires --productId <id>');
+      const body = readData(flags.data) || {};
+      body.productId = body.productId || flags.productId;
+      const res = await api.request('POST', `/hl/v2/memberships/members/${encodeURIComponent(rest[0])}/update`, {
+        apiKey, body,
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'cancel': {
+      if (!rest[0]) throw new Error('Usage: mayar membership cancel <memberId> --productId <id>');
+      if (!flags.productId) throw new Error('mayar membership cancel requires --productId <id>');
+      const res = await api.request('POST', `/hl/v2/memberships/members/${encodeURIComponent(rest[0])}/cancel`, {
+        apiKey, body: { productId: flags.productId },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'create-invoice':
+    case 'createinvoice':
+    case 'invoice': {
+      if (!rest[0]) throw new Error('Usage: mayar membership create-invoice <memberId> --productId <id>');
+      if (!flags.productId) throw new Error('mayar membership create-invoice requires --productId <id>');
+      const res = await api.request('POST', `/hl/v2/memberships/members/${encodeURIComponent(rest[0])}/invoice/create`, {
+        apiKey, body: { productId: flags.productId },
+      });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    default:
+      throw new Error(USAGE);
+  }
+}
+
+module.exports = { run };

package/src/commands/payment-link.js

@@ -0,0 +1,23 @@
+const api = require('../api');
+const ui = require('../ui');
+const { checkResp, readData } = require('../util');
+
+const USAGE = 'Usage: mayar payment-link edit <id> --data <json|@file>';
+
+// Companion to `mayar product edit --type payment-link` — surfaces the alternate
+// v2 route at /hl/v2/payment-links/{id}/update, which the docs confirm shares a
+// handler with /hl/v2/products/payment-link/{id}/update.
+async function run({ apiKey, flags, positional }) {
+  const [sub, ...rest] = positional;
+  if (sub !== 'edit') throw new Error(USAGE);
+  if (!rest[0]) throw new Error(USAGE);
+  const body = readData(flags.data);
+  if (!body) throw new Error('mayar payment-link edit requires --data <json|@file>');
+  body.id = body.id || rest[0];
+  const res = await api.request('POST', `/hl/v2/payment-links/${encodeURIComponent(rest[0])}/update`, {
+    apiKey, body,
+  });
+  checkResp(res); ui.jsonOut(res.body);
+}
+
+module.exports = { run };

package/src/commands/payment.js

@@ -1,44 +1,60 @@
 const api = require('../api');
 const ui = require('../ui');
-const { checkResp, readData } = require('../util');
+const { checkResp, readData, pagination, cursorFooter } = require('../util');
 
-const USAGE = 'Usage: mayar payment <list|get|close|reopen|create>';
+const USAGE = 'Usage: mayar payment <list|get|close|reopen|status|edit|create>';
+const STATUS_ACTIONS = ['open', 'close', 'active', 'closed', 'unlisted'];
 
 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 },
+      const res = await api.request('GET', '/hl/v2/payments', {
+        apiKey, query: pagination(flags, { status: flags.status }),
       });
       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,
+        id: p.id, name: p.name, amount: p.amount, status: p.status,
+        createdAt: typeof p.createdAt === 'number' ? new Date(p.createdAt).toISOString() : (p.createdAt || ''),
       }));
       ui.table(rows, ['id', 'name', 'amount', 'status', 'createdAt']);
+      cursorFooter(res.body, data.length);
       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 });
+      const res = await api.request('GET', `/hl/v2/payments/${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 });
+    case 'close':
+    case 'reopen': {
+      if (!rest[0]) throw new Error(`Usage: mayar payment ${sub} <id>`);
+      const action = sub === 'reopen' ? 'open' : 'close';
+      const res = await api.request('POST', `/hl/v2/payments/${encodeURIComponent(rest[0])}/${action}`, { 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 });
+    case 'status': {
+      if (!rest[0] || !rest[1]) throw new Error(`Usage: mayar payment status <id> <${STATUS_ACTIONS.join('|')}>`);
+      if (!STATUS_ACTIONS.includes(rest[1])) {
+        throw new Error(`Invalid action "${rest[1]}". Must be one of: ${STATUS_ACTIONS.join(', ')}`);
+      }
+      const res = await api.request('POST', `/hl/v2/payments/${encodeURIComponent(rest[0])}/${rest[1]}`, { apiKey });
+      checkResp(res); ui.jsonOut(res.body); return;
+    }
+    case 'edit': {
+      if (!rest[0]) throw new Error('Usage: mayar payment edit <id> --data <json|@file>');
+      const body = readData(flags.data);
+      if (!body) throw new Error('mayar payment edit requires --data <json|@file>');
+      body.id = body.id || rest[0];
+      const res = await api.request('POST', `/hl/v2/payments/${encodeURIComponent(rest[0])}/update`, { apiKey, body });
       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 });
+      if (!body) throw new Error('mayar payment create requires --data <json|@file>');
+      const res = await api.request('POST', '/hl/v2/payments/create', { apiKey, body });
       checkResp(res); ui.jsonOut(res.body); return;
     }
     default: