not-manage 0.2.0 → 0.2.2

package/src/resource-query-builder.js

@@ -0,0 +1,80 @@
+const { compactQuery, parseLimit } = require("./resource-utils");
+
+function toSnakeCase(name) {
+  return String(name).replace(/-/g, "_");
+}
+
+function deriveQueryKey(propertyName, optionDef) {
+  if (!optionDef || optionDef.query === false || optionDef.positional !== undefined) {
+    return null;
+  }
+
+  if (optionDef.query) {
+    return optionDef.query;
+  }
+
+  if (propertyName === "all") {
+    return null;
+  }
+
+  return optionDef.option ? toSnakeCase(optionDef.option) : null;
+}
+
+function readQueryValue(propertyName, optionDef, options, resourceMetadata, config) {
+  if (propertyName === "fields") {
+    return options.fields || resourceMetadata.defaultFields?.list;
+  }
+
+  if (propertyName === "limit") {
+    return parseLimit(options.limit, config.limitMax);
+  }
+
+  const value = options[propertyName];
+  if (value === undefined || value === null || value === "") {
+    return undefined;
+  }
+
+  if (optionDef.kind === "flag") {
+    return value ? true : undefined;
+  }
+
+  if (optionDef.kind === "boolean") {
+    return Boolean(value);
+  }
+
+  return value;
+}
+
+function buildListQueryFromResource(resourceMetadata, options = {}, config = {}) {
+  const schema = resourceMetadata?.optionSchema?.list || {};
+  const query = {};
+
+  Object.entries(schema).forEach(([propertyName, optionDef]) => {
+    const queryKey = deriveQueryKey(propertyName, optionDef);
+    if (!queryKey) {
+      return;
+    }
+
+    query[queryKey] = readQueryValue(
+      propertyName,
+      optionDef,
+      options,
+      resourceMetadata,
+      config
+    );
+  });
+
+  const withExtra =
+    typeof config.transform === "function"
+      ? config.transform(compactQuery({ ...query }), options)
+      : query;
+
+  return compactQuery({
+    ...(withExtra || {}),
+    ...(config.extraQuery || {}),
+  });
+}
+
+module.exports = {
+  buildListQueryFromResource,
+};

package/src/resource-utils.js

@@ -65,6 +65,50 @@ function readMatterLabel(matter) {
   return matter.display_number || matter.number || matter.description || String(matter.id || "-");
 }
 
+function readStatus(status) {
+  if (!status) {
+    return "-";
+  }
+
+  if (typeof status === "string") {
+    return status;
+  }
+
+  return status.name || status.value || status.state || "-";
+}
+
+function readHours(activity) {
+  const quantityInHours = Number(activity?.quantity_in_hours);
+  if (Number.isFinite(quantityInHours)) {
+    return quantityInHours.toFixed(2);
+  }
+
+  const quantity = Number(activity?.quantity);
+  if (Number.isFinite(quantity)) {
+    return (quantity / 3600).toFixed(2);
+  }
+
+  return "-";
+}
+
+function readRoleList(user) {
+  const roles = Array.isArray(user?.roles) ? user.roles : [];
+  if (roles.length === 0) {
+    return "-";
+  }
+
+  return roles.join(", ");
+}
+
+function readFirstMatterLabel(record) {
+  const matters = Array.isArray(record?.matters) ? record.matters : [];
+  if (matters.length === 0) {
+    return "-";
+  }
+
+  return readMatterLabel(matters[0]);
+}
+
 function formatBoolean(value) {
   if (value === undefined || value === null) {
     return "-";
@@ -136,6 +180,10 @@ module.exports = {
   parseLimit,
   printKeyValueRows,
   readContactName,
+  readFirstMatterLabel,
+  readHours,
   readMatterLabel,
+  readRoleList,
+  readStatus,
   readUserName,
 };

package/src/commands-billable-clients.js

@@ -1,105 +0,0 @@
-const {
-  clip,
-  compactQuery,
-  formatMoney,
-  parseLimit,
-  printKeyValueRows,
-} = require("./resource-utils");
-const { createListCommand } = require("./resource-command-runner");
-const { getResourceMetadata } = require("./resource-metadata");
-
-const BILLABLE_CLIENT_RESOURCE = getResourceMetadata("billable-clients");
-
-function buildBillableClientQuery(options) {
-  return compactQuery({
-    client_id: options.clientId || undefined,
-    end_date: options.endDate || undefined,
-    fields: options.fields || BILLABLE_CLIENT_RESOURCE.defaultFields.list,
-    limit: parseLimit(options.limit, 25),
-    matter_id: options.matterId || undefined,
-    originating_attorney_id: options.originatingAttorneyId || undefined,
-    page_token: options.pageToken || undefined,
-    query: options.query || undefined,
-    responsible_attorney_id: options.responsibleAttorneyId || undefined,
-    start_date: options.startDate || undefined,
-  });
-}
-
-function formatBillableClientRow(record) {
-  return {
-    amount: formatMoney(record.unbilled_amount),
-    hours:
-      record.unbilled_hours === undefined || record.unbilled_hours === null
-        ? "-"
-        : Number(record.unbilled_hours).toFixed(2),
-    id: String(record.id || "-"),
-    matters: String(record.billable_matters_count ?? "-"),
-    name: String(record.name || "-"),
-    trust: formatMoney(record.amount_in_trust),
-  };
-}
-
-function printBillableClientList(rows, options) {
-  if (rows.length === 0) {
-    console.log("No billable clients found for the selected filters.");
-    return;
-  }
-
-  const visibleRows = rows.slice(0, 50);
-  console.log("ID       NAME                         HOURS AMOUNT     TRUST      MATTERS");
-  console.log("-------- ---------------------------- ----- ---------- ---------- -------");
-
-  visibleRows.forEach((row) => {
-    const line = [
-      clip(row.id, 8).padEnd(8, " "),
-      clip(row.name, 28).padEnd(28, " "),
-      clip(row.hours, 5).padEnd(5, " "),
-      clip(row.amount, 10).padEnd(10, " "),
-      clip(row.trust, 10).padEnd(10, " "),
-      clip(row.matters, 7),
-    ].join(" ");
-
-    console.log(line);
-  });
-
-  if (rows.length > visibleRows.length) {
-    console.log(`Showing ${visibleRows.length} of ${rows.length} billable clients. Use --json for full output.`);
-  }
-
-  if (!options.all && options.nextPageUrl) {
-    console.log("");
-    console.log("More results are available.");
-    console.log("Run again with `--all` or pass `--page-token` from `--json` output.");
-  }
-}
-
-function printBillableClient(record) {
-  printKeyValueRows([
-    ["ID", record.id],
-    ["Name", record.name],
-    ["Unbilled Hours", record.unbilled_hours],
-    ["Unbilled Amount", formatMoney(record.unbilled_amount)],
-    ["Amount In Trust", formatMoney(record.amount_in_trust)],
-    ["Billable Matters", record.billable_matters_count],
-  ]);
-}
-
-const billableClientsList = createListCommand({
-  apiPath: BILLABLE_CLIENT_RESOURCE.apiPath,
-  buildQuery: buildBillableClientQuery,
-  formatRow: formatBillableClientRow,
-  pluralLabel: BILLABLE_CLIENT_RESOURCE.summaryLabels.plural,
-  printList: printBillableClientList,
-  redactionResourceType: BILLABLE_CLIENT_RESOURCE.redaction.resourceType,
-  singularLabel: BILLABLE_CLIENT_RESOURCE.summaryLabels.singular,
-});
-
-module.exports = {
-  billableClientsList,
-  __private: {
-    buildBillableClientQuery,
-    formatBillableClientRow,
-    printBillableClient,
-    printBillableClientList,
-  },
-};

package/src/commands-billable-matters.js

@@ -1,106 +0,0 @@
-const {
-  clip,
-  compactQuery,
-  formatMoney,
-  parseLimit,
-  printKeyValueRows,
-  readContactName,
-} = require("./resource-utils");
-const { createListCommand } = require("./resource-command-runner");
-const { getResourceMetadata } = require("./resource-metadata");
-
-const BILLABLE_MATTER_RESOURCE = getResourceMetadata("billable-matters");
-
-function buildBillableMatterQuery(options) {
-  return compactQuery({
-    client_id: options.clientId || undefined,
-    end_date: options.endDate || undefined,
-    fields: options.fields || BILLABLE_MATTER_RESOURCE.defaultFields.list,
-    limit: parseLimit(options.limit, 1000),
-    matter_id: options.matterId || undefined,
-    originating_attorney_id: options.originatingAttorneyId || undefined,
-    page_token: options.pageToken || undefined,
-    query: options.query || undefined,
-    responsible_attorney_id: options.responsibleAttorneyId || undefined,
-    start_date: options.startDate || undefined,
-  });
-}
-
-function formatBillableMatterRow(record) {
-  return {
-    amount: formatMoney(record.unbilled_amount),
-    client: readContactName(record.client),
-    hours:
-      record.unbilled_hours === undefined || record.unbilled_hours === null
-        ? "-"
-        : Number(record.unbilled_hours).toFixed(2),
-    id: String(record.id || "-"),
-    matter: String(record.display_number || "-"),
-    trust: formatMoney(record.amount_in_trust),
-  };
-}
-
-function printBillableMatterList(rows, options) {
-  if (rows.length === 0) {
-    console.log("No billable matters found for the selected filters.");
-    return;
-  }
-
-  const visibleRows = rows.slice(0, 50);
-  console.log("ID       MATTER                CLIENT               HOURS AMOUNT     TRUST");
-  console.log("-------- --------------------- -------------------- ----- ---------- ----------");
-
-  visibleRows.forEach((row) => {
-    const line = [
-      clip(row.id, 8).padEnd(8, " "),
-      clip(row.matter, 21).padEnd(21, " "),
-      clip(row.client, 20).padEnd(20, " "),
-      clip(row.hours, 5).padEnd(5, " "),
-      clip(row.amount, 10).padEnd(10, " "),
-      clip(row.trust, 10),
-    ].join(" ");
-
-    console.log(line);
-  });
-
-  if (rows.length > visibleRows.length) {
-    console.log(`Showing ${visibleRows.length} of ${rows.length} billable matters. Use --json for full output.`);
-  }
-
-  if (!options.all && options.nextPageUrl) {
-    console.log("");
-    console.log("More results are available.");
-    console.log("Run again with `--all` or pass `--page-token` from `--json` output.");
-  }
-}
-
-function printBillableMatter(record) {
-  printKeyValueRows([
-    ["ID", record.id],
-    ["Matter", record.display_number],
-    ["Client", readContactName(record.client)],
-    ["Unbilled Hours", record.unbilled_hours],
-    ["Unbilled Amount", formatMoney(record.unbilled_amount)],
-    ["Amount In Trust", formatMoney(record.amount_in_trust)],
-  ]);
-}
-
-const billableMattersList = createListCommand({
-  apiPath: BILLABLE_MATTER_RESOURCE.apiPath,
-  buildQuery: buildBillableMatterQuery,
-  formatRow: formatBillableMatterRow,
-  pluralLabel: BILLABLE_MATTER_RESOURCE.summaryLabels.plural,
-  printList: printBillableMatterList,
-  redactionResourceType: BILLABLE_MATTER_RESOURCE.redaction.resourceType,
-  singularLabel: BILLABLE_MATTER_RESOURCE.summaryLabels.singular,
-});
-
-module.exports = {
-  billableMattersList,
-  __private: {
-    buildBillableMatterQuery,
-    formatBillableMatterRow,
-    printBillableMatter,
-    printBillableMatterList,
-  },
-};

package/src/commands-bills.js

@@ -1,192 +0,0 @@
-const {
-  clip,
-  compactQuery,
-  formatMoney,
-  parseLimit,
-  printKeyValueRows,
-  readContactName,
-  readMatterLabel,
-} = require("./resource-utils");
-const { createGetCommand, createListCommand } = require("./resource-command-runner");
-const { getResourceMetadata } = require("./resource-metadata");
-
-const BILL_RESOURCE = getResourceMetadata("bills");
-const VALID_BILL_STATUSES = new Set(["all", "overdue"]);
-
-function normalizeBillStatusFilters(options = {}) {
-  const state =
-    typeof options.state === "string"
-      ? options.state.trim() || undefined
-      : options.state || undefined;
-
-  if (options.status === undefined || options.status === null || options.status === "") {
-    return { state, status: undefined };
-  }
-
-  if (typeof options.status !== "string") {
-    throw new Error(
-      "Invalid value for --status on bills/invoices. Use `all`, `overdue`, or `unpaid`."
-    );
-  }
-
-  const status = options.status.trim().toLowerCase();
-
-  if (!status) {
-    throw new Error(
-      "Invalid value for --status on bills/invoices. Use `all`, `overdue`, or `unpaid`."
-    );
-  }
-
-  if (status === "unpaid") {
-    if (state && state !== "awaiting_payment") {
-      throw new Error(
-        "`--status unpaid` conflicts with `--state`. Use `--state awaiting_payment` or remove one of the filters."
-      );
-    }
-
-    return {
-      state: state || "awaiting_payment",
-      status: undefined,
-    };
-  }
-
-  if (!VALID_BILL_STATUSES.has(status)) {
-    throw new Error(
-      "Invalid value for --status on bills/invoices. Use `all`, `overdue`, or `unpaid`."
-    );
-  }
-
-  return { state, status };
-}
-
-function buildBillQuery(options) {
-  const filters = normalizeBillStatusFilters(options);
-
-  return compactQuery({
-    client_id: options.clientId || undefined,
-    created_since: options.createdSince || undefined,
-    due_after: options.dueAfter || undefined,
-    due_before: options.dueBefore || undefined,
-    fields: options.fields || BILL_RESOURCE.defaultFields.list,
-    issued_after: options.issuedAfter || undefined,
-    issued_before: options.issuedBefore || undefined,
-    limit: parseLimit(options.limit),
-    matter_id: options.matterId || undefined,
-    order: options.order || undefined,
-    overdue_only: options.overdueOnly ? true : undefined,
-    page_token: options.pageToken || undefined,
-    query: options.query || undefined,
-    state: filters.state,
-    status: filters.status,
-    type: options.type || undefined,
-    updated_since: options.updatedSince || undefined,
-  });
-}
-
-function readFirstMatterLabel(bill) {
-  const matters = Array.isArray(bill.matters) ? bill.matters : [];
-  if (matters.length === 0) {
-    return "-";
-  }
-
-  return readMatterLabel(matters[0]);
-}
-
-function formatBillRow(bill) {
-  return {
-    id: String(bill.id || "-"),
-    number: String(bill.number || "-"),
-    state: String(bill.state || "-"),
-    client: readContactName(bill.client),
-    dueAt: String(bill.due_at || "-"),
-    balance: formatMoney(bill.balance),
-  };
-}
-
-function printBillList(rows, options) {
-  if (rows.length === 0) {
-    console.log("No bills found for the selected filters.");
-    return;
-  }
-
-  const visibleRows = rows.slice(0, 50);
-  console.log("ID       BILL           STATE        CLIENT                       DUE          BALANCE");
-  console.log("-------- -------------- ------------ ---------------------------- ------------ ----------");
-
-  visibleRows.forEach((row) => {
-    const line = [
-      clip(row.id, 8).padEnd(8, " "),
-      clip(row.number, 14).padEnd(14, " "),
-      clip(row.state, 12).padEnd(12, " "),
-      clip(row.client, 28).padEnd(28, " "),
-      clip(row.dueAt, 12).padEnd(12, " "),
-      clip(row.balance, 10),
-    ].join(" ");
-
-    console.log(line);
-  });
-
-  if (rows.length > visibleRows.length) {
-    console.log(`Showing ${visibleRows.length} of ${rows.length} bills. Use --json for full output.`);
-  }
-
-  if (!options.all && options.nextPageUrl) {
-    console.log("");
-    console.log("More results are available.");
-    console.log("Run again with `--all` or pass `--page-token` from `--json` output.");
-  }
-}
-
-function printBill(bill) {
-  printKeyValueRows([
-    ["ID", bill.id],
-    ["Number", bill.number],
-    ["State", bill.state],
-    ["Type", bill.type],
-    ["Kind", bill.kind],
-    ["Client", readContactName(bill.client)],
-    ["Matter", readFirstMatterLabel(bill)],
-    ["Issued", bill.issued_at],
-    ["Due", bill.due_at],
-    ["Total", formatMoney(bill.total)],
-    ["Balance", formatMoney(bill.balance)],
-    ["Paid", formatMoney(bill.paid)],
-    ["Paid At", bill.paid_at],
-    ["Pending", formatMoney(bill.pending)],
-    ["Due Amount", formatMoney(bill.due)],
-    ["Subject", bill.subject],
-    ["Memo", bill.memo],
-    ["Created", bill.created_at],
-    ["Updated", bill.updated_at],
-  ]);
-}
-
-const billsList = createListCommand({
-  apiPath: BILL_RESOURCE.apiPath,
-  buildQuery: buildBillQuery,
-  formatRow: formatBillRow,
-  pluralLabel: BILL_RESOURCE.summaryLabels.plural,
-  printList: printBillList,
-  redactionResourceType: BILL_RESOURCE.redaction.resourceType,
-  singularLabel: BILL_RESOURCE.summaryLabels.singular,
-});
-
-const billsGet = createGetCommand({
-  apiPath: BILL_RESOURCE.apiPath,
-  defaultFields: BILL_RESOURCE.defaultFields.get,
-  printItem: printBill,
-  redactionResourceType: BILL_RESOURCE.redaction.resourceType,
-  usage: "Usage: not-manage bills get <id> [--fields ...] [--json]",
-});
-
-module.exports = {
-  billsGet,
-  billsList,
-  __private: {
-    buildBillQuery,
-    formatBillRow,
-    normalizeBillStatusFilters,
-    printBill,
-    printBillList,
-  },
-};

package/src/commands-contacts.js

@@ -1,121 +0,0 @@
-const {
-  clip,
-  compactQuery,
-  formatBoolean,
-  parseLimit,
-  printKeyValueRows,
-  readContactName,
-} = require("./resource-utils");
-const { createGetCommand, createListCommand } = require("./resource-command-runner");
-const { getResourceMetadata } = require("./resource-metadata");
-
-const CONTACT_RESOURCE = getResourceMetadata("contacts");
-
-function buildContactQuery(options) {
-  return compactQuery({
-    client_only: options.clientOnly ? true : undefined,
-    clio_connect_only: options.clioConnectOnly ? true : undefined,
-    created_since: options.createdSince || undefined,
-    email_only: options.emailOnly ? true : undefined,
-    fields: options.fields || CONTACT_RESOURCE.defaultFields.list,
-    initial: options.initial || undefined,
-    limit: parseLimit(options.limit),
-    order: options.order || undefined,
-    page_token: options.pageToken || undefined,
-    query: options.query || undefined,
-    type: options.type || undefined,
-    updated_since: options.updatedSince || undefined,
-  });
-}
-
-function formatContactRow(contact) {
-  return {
-    id: String(contact.id || "-"),
-    name: readContactName(contact),
-    type: String(contact.type || "-"),
-    client: formatBoolean(contact.is_client),
-    email: String(contact.primary_email_address || "-"),
-    phone: String(contact.primary_phone_number || "-"),
-  };
-}
-
-function printContactList(rows, options) {
-  if (rows.length === 0) {
-    console.log("No contacts found for the selected filters.");
-    return;
-  }
-
-  const visibleRows = rows.slice(0, 50);
-  console.log("ID       NAME                         TYPE         CLIENT EMAIL                        PHONE");
-  console.log("-------- ---------------------------- ------------ ------ ---------------------------- ------------------");
-
-  visibleRows.forEach((row) => {
-    const line = [
-      clip(row.id, 8).padEnd(8, " "),
-      clip(row.name, 28).padEnd(28, " "),
-      clip(row.type, 12).padEnd(12, " "),
-      clip(row.client, 6).padEnd(6, " "),
-      clip(row.email, 28).padEnd(28, " "),
-      clip(row.phone, 18),
-    ].join(" ");
-
-    console.log(line);
-  });
-
-  if (rows.length > visibleRows.length) {
-    console.log(`Showing ${visibleRows.length} of ${rows.length} contacts. Use --json for full output.`);
-  }
-
-  if (!options.all && options.nextPageUrl) {
-    console.log("");
-    console.log("More results are available.");
-    console.log("Run again with `--all` or pass `--page-token` from `--json` output.");
-  }
-}
-
-function printContact(contact) {
-  printKeyValueRows([
-    ["ID", contact.id],
-    ["Name", readContactName(contact)],
-    ["Type", contact.type],
-    ["Client", formatBoolean(contact.is_client)],
-    ["Primary Email", contact.primary_email_address],
-    ["Secondary Email", contact.secondary_email_address],
-    ["Primary Phone", contact.primary_phone_number],
-    ["Secondary Phone", contact.secondary_phone_number],
-    ["Clio Connect Email", contact.clio_connect_email],
-    ["Title", contact.title],
-    ["Prefix", contact.prefix],
-    ["Created", contact.created_at],
-    ["Updated", contact.updated_at],
-  ]);
-}
-
-const contactsList = createListCommand({
-  apiPath: CONTACT_RESOURCE.apiPath,
-  buildQuery: buildContactQuery,
-  formatRow: formatContactRow,
-  pluralLabel: CONTACT_RESOURCE.summaryLabels.plural,
-  printList: printContactList,
-  redactionResourceType: CONTACT_RESOURCE.redaction.resourceType,
-  singularLabel: CONTACT_RESOURCE.summaryLabels.singular,
-});
-
-const contactsGet = createGetCommand({
-  apiPath: CONTACT_RESOURCE.apiPath,
-  defaultFields: CONTACT_RESOURCE.defaultFields.get,
-  printItem: printContact,
-  redactionResourceType: CONTACT_RESOURCE.redaction.resourceType,
-  usage: "Usage: not-manage contacts get <id> [--fields ...] [--json]",
-});
-
-module.exports = {
-  contactsGet,
-  contactsList,
-  __private: {
-    buildContactQuery,
-    formatContactRow,
-    printContact,
-    printContactList,
-  },
-};