bamboohr-cli 1.0.19 → 1.0.20

package/dist/index.js

@@ -68,6 +68,58 @@ function positiveInt(raw) {
   return n;
 }
 
+// ../../cli-utils/dist/text-or-file.js
+import { readFileSync as readFileSync3 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError2, Option } from "commander";
+var STDIN_REF = "-";
+function rejectStdinSentinel(value) {
+  if (value === "@-" || value === STDIN_REF) {
+    throw new InvalidArgumentError2(`"${value}" looks like a stdin redirect, which is not supported here. Pass the text directly, or read it from a file/stdin with the matching --\u2026-file <path|-> option.`);
+  }
+  return value;
+}
+function readFileOrStdin(ref) {
+  if (ref === STDIN_REF) {
+    if (process.stdin.isTTY) {
+      throw new InvalidArgumentError2('"--\u2026-file -" reads stdin, but stdin is a terminal (nothing piped).');
+    }
+    try {
+      return readFileSync3(0, "utf8");
+    } catch (err) {
+      throw new InvalidArgumentError2(`failed to read stdin for "--\u2026-file -": ${err.message}`);
+    }
+  }
+  try {
+    return readFileSync3(ref, "utf8");
+  } catch (err) {
+    const e = err;
+    if (e.code === "ENOENT") {
+      throw new InvalidArgumentError2(`file not found: "${ref}".`);
+    }
+    throw new InvalidArgumentError2(`failed to read file "${ref}": ${e.message}`);
+  }
+}
+function textOrFileOption(cmd, name, opts = {}) {
+  const label = `${name.charAt(0).toUpperCase()}${name.slice(1)} content`;
+  cmd.option(`--${name} <text>`, opts.description ?? label, rejectStdinSentinel);
+  cmd.addOption(new Option(`--${name}-file <path>`, `Read --${name} from a file, or "-" for stdin (mutually exclusive with --${name})`).conflicts(name));
+  return cmd;
+}
+function resolveTextOrFile(opts, name, { required = true } = {}) {
+  const literal = opts[name];
+  const ref = opts[`${name}File`];
+  if (literal !== void 0 && ref !== void 0) {
+    throw new InvalidArgumentError2(`--${name} and --${name}-file are mutually exclusive; provide only one.`);
+  }
+  if (ref !== void 0) {
+    return readFileOrStdin(ref);
+  }
+  if (literal === void 0 && required) {
+    throw new InvalidArgumentError2(`a ${name} is required: provide --${name} <text> or --${name}-file <path>.`);
+  }
+  return literal;
+}
+
 // ../../cli-utils/dist/builders.js
 var EXAMPLES = /* @__PURE__ */ new WeakSet();
 function commandPath(cmd) {
@@ -496,10 +548,10 @@ function mergeFields(existing, extra) {
 }
 
 // src/commands/employee/goals.ts
-import { Option } from "commander";
+import { Option as Option2 } from "commander";
 var GOAL_FILTERS = ["open", "closed", "all"];
 function goals(parent) {
-  const cmd = parent.command("goals <employeeId>").description("Get employee performance goals").addOption(new Option("--filter <filter>", "Filter goals by status").choices(GOAL_FILTERS).default("all"));
+  const cmd = parent.command("goals <employeeId>").description("Get employee performance goals").addOption(new Option2("--filter <filter>", "Filter goals by status").choices(GOAL_FILTERS).default("all"));
   examples(cmd, ["123", ["123 --filter open", "only open goals"], ["123 --filter closed", "only closed goals"]]);
   cmd.action(async (employeeId, opts) => {
     const client = getClient();
@@ -513,10 +565,10 @@ function goals(parent) {
 
 // src/commands/employee/photo.ts
 import { writeFileSync as writeFileSync2 } from "fs";
-import { Option as Option2 } from "commander";
+import { Option as Option3 } from "commander";
 var PHOTO_SIZES = ["original", "large", "medium", "small", "xs", "tiny"];
 function photo(parent) {
-  const cmd = parent.command("photo <employeeId>").description("Download employee photo").requiredOption("--output <path>", "File path to save photo").addOption(new Option2("--size <size>", "Photo size").choices(PHOTO_SIZES).default("medium"));
+  const cmd = parent.command("photo <employeeId>").description("Download employee photo").requiredOption("--output <path>", "File path to save photo").addOption(new Option3("--size <size>", "Photo size").choices(PHOTO_SIZES).default("medium"));
   examples(cmd, [["123 --output ./photo.jpg", "medium size (default)"], "123 --output ./photo.jpg --size large"]);
   cmd.action(async (employeeId, opts) => {
     const client = getClient();
@@ -704,11 +756,12 @@ function balance(parent) {
 }
 
 // src/commands/timeoff/create.ts
-import { Option as Option3 } from "commander";
+import { Option as Option4 } from "commander";
 function create(parent) {
   const cmd = parent.command("create [employeeId]").description("Create a time off request (defaults to current user)").requiredOption("--start-date <date>", "Start date (YYYY-MM-DD)").requiredOption("--end-date <date>", "End date (YYYY-MM-DD)").requiredOption("--type-id <id>", 'Time off type ID (use "timeoff types" to find IDs)', positiveInt).requiredOption("--amount <amount>", "Total amount of time off (in days or hours depending on type)", parseFloat).addOption(
-    new Option3("--status <status>", "Request status").choices(["requested", "approved"]).default("requested")
-  ).option("--note <text>", "Note to include with the request").option("--dates <json>", `Per-day amounts as JSON array, e.g. '[{"ymd":"2026-03-21","amount":4}]' for half-day`);
+    new Option4("--status <status>", "Request status").choices(["requested", "approved"]).default("requested")
+  ).option("--dates <json>", `Per-day amounts as JSON array, e.g. '[{"ymd":"2026-03-21","amount":4}]' for half-day`);
+  textOrFileOption(cmd, "note", { description: "Note to include with the request" });
   examples(cmd, [
     "--start-date 2026-04-01 --end-date 2026-04-01 --type-id 83 --amount 1",
     [
@@ -720,6 +773,7 @@ function create(parent) {
     async (employeeId, opts) => {
       const client = getClient();
       const id = await resolveEmployeeId(client, employeeId);
+      const note = resolveTextOrFile(opts, "note", { required: false });
       const result = await client.timeOff.createRequest({
         employeeId: id,
         status: opts.status,
@@ -727,7 +781,7 @@ function create(parent) {
         end: opts.endDate,
         timeOffTypeId: opts.typeId,
         amount: opts.amount,
-        notes: opts.note ? [{ from: "employee", note: opts.note }] : void 0,
+        notes: note ? [{ from: "employee", note }] : void 0,
         dates: opts.dates ? JSON.parse(opts.dates) : void 0
       });
       output(
@@ -738,10 +792,10 @@ function create(parent) {
 }
 
 // src/commands/timeoff/requests.ts
-import { Option as Option4 } from "commander";
+import { Option as Option5 } from "commander";
 function requests(parent) {
-  const cmd = parent.command("requests").description("Get time off requests (defaults to current user)").option("--request-id <id>", "Specific request ID", positiveInt).addOption(new Option4("--action <action>", "Access level filter").choices(["view", "approve"])).option("--employee-id <id>", "Filter by employee ID").option("--all", "Show all visible requests instead of just current user").option("--start-date <date>", "Start date (YYYY-MM-DD)").option("--end-date <date>", "End date (YYYY-MM-DD)").addOption(
-    new Option4("--status <status>", "Filter by request status").choices([
+  const cmd = parent.command("requests").description("Get time off requests (defaults to current user)").option("--request-id <id>", "Specific request ID", positiveInt).addOption(new Option5("--action <action>", "Access level filter").choices(["view", "approve"])).option("--employee-id <id>", "Filter by employee ID").option("--all", "Show all visible requests instead of just current user").option("--start-date <date>", "Start date (YYYY-MM-DD)").option("--end-date <date>", "End date (YYYY-MM-DD)").addOption(
+    new Option5("--status <status>", "Filter by request status").choices([
       "approved",
       "denied",
       "superceded",
@@ -791,25 +845,29 @@ function types(parent) {
 }
 
 // src/commands/timeoff/update-status.ts
-import { Option as Option5 } from "commander";
+import { Option as Option6 } from "commander";
 function updateStatus(parent) {
   const cmd = parent.command("update-status <requestId>").description("Update time off request status (approve, deny, cancel)").addOption(
-    new Option5("--status <status>", "New status").choices(["approved", "denied", "canceled"]).makeOptionMandatory()
-  ).option("--note <text>", "Note to attach to the status change");
+    new Option6("--status <status>", "New status").choices(["approved", "denied", "canceled"]).makeOptionMandatory()
+  );
+  textOrFileOption(cmd, "note", { description: "Note to attach to the status change" });
   examples(cmd, [
     "7890 --status approved",
     ['7890 --status denied --note "Team at capacity that week"', "deny with note"],
     "7890 --status canceled"
   ]);
-  cmd.action(async (requestId, opts) => {
-    const client = getClient();
-    const result = await client.timeOff.updateRequestStatus({
-      requestId,
-      status: opts.status,
-      note: opts.note
-    });
-    output(result ? stripNullish(result) : { updated: true, requestId, status: opts.status });
-  });
+  cmd.action(
+    async (requestId, opts) => {
+      const client = getClient();
+      const note = resolveTextOrFile(opts, "note", { required: false });
+      const result = await client.timeOff.updateRequestStatus({
+        requestId,
+        status: opts.status,
+        note
+      });
+      output(result ? stripNullish(result) : { updated: true, requestId, status: opts.status });
+    }
+  );
 }
 
 // src/commands/timeoff/whos-out.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bamboohr-cli",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -22,8 +22,8 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.16",
-    "cli-utils": "1.0.0",
     "config-eslint": "0.0.0",
+    "cli-utils": "1.0.0",
     "config-typescript": "0.0.0"
   },
   "engines": {