@zeegme/cli 0.4.0 → 0.5.0

package/dist/commands/bookings.js

@@ -1,6 +1,7 @@
+import { Option } from 'commander';
 import { unwrap } from '../api/client.js';
 import { UsageError } from '../errors.js';
-import { asJson, clockTime, collect, isoDate, localTimeZone, positiveInt } from './util.js';
+import { asJson, clockTime, collect, isoDate, localTimeZone, overrideLevelOption, positiveInt } from './util.js';
 const inviteeNames = (row) => (row.invitees ?? []).map((invitee) => invitee.fullName ?? invitee.email);
 export function registerBookings(program, context) {
     const bookings = program.command('bookings').description('Scheduled events (bookings)');
@@ -67,6 +68,8 @@ export function registerBookings(program, context) {
         .option('--guest <email>', 'add a guest, repeatable', collect)
         .option('--location <type>', 'location type, when the event type offers several')
         .option('--location-key <key>', 'exact location key from the event type')
+        .option('--host <email>', 'book with this host (Round Robin event types only)')
+        .addOption(overrideLevelOption())
         .option('-y, --yes', 'book without asking')
         .action(async (uuid, options) => {
         const ctx = context();
@@ -85,6 +88,8 @@ export function registerBookings(program, context) {
                 guests: options.guest,
                 location: options.location,
                 locationKey: options.locationKey,
+                hostEmail: options.host,
+                overrideLevel: options.overrideLevel,
             },
         })));
         ctx.print.record(data, `Booked: ${data.title ?? 'meeting'} at ${data.startTime ?? `${options.date} ${options.time}`} (${data.uuid}).`);
@@ -111,13 +116,14 @@ export function registerBookings(program, context) {
         .option('--tz <zone>', 'IANA time zone of --date and --time (default: the invitee’s)')
         .option('--duration <minutes>', 'new length', positiveInt('--duration'))
         .option('--reason <text>', 'shown to the invitees')
+        .addOption(overrideLevelOption())
         .option('-y, --yes', 'reschedule without asking')
         .action(async (uuid, options) => {
         const ctx = context();
         await ctx.confirm(`Move booking ${uuid} to ${options.date} ${options.time}? The invitees are notified.`, options.yes);
         const data = asJson(await unwrap((await ctx.api()).PUT('/scheduled-events/{uuid}/reschedule', {
             params: { path: { uuid } },
-            body: { date: options.date, start: options.time, timeZone: options.tz, duration: options.duration, reason: options.reason },
+            body: { date: options.date, start: options.time, timeZone: options.tz, duration: options.duration, reason: options.reason, overrideLevel: options.overrideLevel },
         })));
         ctx.print.record(data.resource, `Rescheduled ${uuid} to ${options.date} ${options.time}.`);
     });
@@ -142,8 +148,9 @@ export function registerBookings(program, context) {
         .command('hand-over <uuid>')
         .description('Hand a round-robin booking to another host')
         .option('--to <email>', 'the new host (default: Zeeg picks the next available host)')
-        .option('--require-availability', 'only hand over to a host who is free then')
-        .option('--fallback-to-reschedule', 'offer the invitee a reschedule when nobody is free')
+        .addOption(new Option('--require-availability', 'accepted and ignored').hideHelp())
+        .option('--fallback-to-reschedule', 'when the booking cannot move in place, reschedule it to the new host at the same time; the booking gets a new uuid')
+        .addOption(overrideLevelOption())
         .option('-y, --yes', 'hand over without asking')
         .action(async (uuid, options) => {
         const ctx = context();
@@ -152,8 +159,8 @@ export function registerBookings(program, context) {
             params: { path: { uuid } },
             body: {
                 newHostEmail: options.to,
-                requireHostAvailability: options.requireAvailability,
                 fallbackToReschedule: options.fallbackToReschedule,
+                overrideLevel: options.overrideLevel,
             },
         }));
         ctx.print.record(asJson(data).resource, `Handed over ${uuid}.`);

package/dist/commands/util.js

@@ -1,4 +1,5 @@
 import { readFile } from 'node:fs/promises';
+import { Option } from 'commander';
 import { UsageError } from '../errors.js';
 export function asJson(value) {
     return value !== null && typeof value === 'object' ? value : {};
@@ -12,6 +13,18 @@ export function positiveInt(name) {
         return value;
     };
 }
+export function overrideLevel(name) {
+    return (raw) => {
+        if (!/^[1-4]$/.test(raw)) {
+            throw new UsageError(`${name} must be 1, 2, 3 or 4, not "${raw}".`);
+        }
+        return Number(raw);
+    };
+}
+/** `--override-level`, shared by every command that can book outside availability. */
+export function overrideLevelOption() {
+    return new Option('--override-level <level>', 'book outside availability: 2 also outside working hours, 3 also over calendar entries, 4 also over other bookings (double-books the host)').argParser(overrideLevel('--override-level'));
+}
 export function isoDate(name) {
     return (raw) => {
         if (!/^\d{4}-\d{2}-\d{2}$/.test(raw) || Number.isNaN(Date.parse(raw))) {

package/dist/errors.js

@@ -45,7 +45,8 @@ export function exitCodeFor(error) {
 /**
  * The API answers errors in two shapes: controllers and validation send `{ message, errors? }`,
  * with validation messages listed per field, and the shared exception handler sends
- * `{ error: { type, message } }` for not found, forbidden and similar. A 401 means the token was
+ * `{ error: { type, message } }` for not found, forbidden and similar. A refused override carries
+ * `data.blockedReason`, the kind of entry that blocks the time (such as `calendar`). A 401 means the token was
  * revoked or expired server-side, so it asks for a new login.
  */
 export function apiErrorFrom(status, body) {
@@ -60,7 +61,9 @@ export function apiErrorFrom(status, body) {
         ? Object.values(record.errors).flat().filter((item) => typeof item === 'string')
         : [];
     const unique = details.filter((detail) => detail !== message);
-    return new ApiError(unique.length > 0 ? `${message}\n- ${unique.join('\n- ')}` : message);
+    const data = typeof record.data === 'object' && record.data !== null ? record.data : {};
+    const blocked = typeof data.blockedReason === 'string' && data.blockedReason !== '' ? `\nBlocked by: ${data.blockedReason}` : '';
+    return new ApiError((unique.length > 0 ? `${message}\n- ${unique.join('\n- ')}` : message) + blocked);
 }
 /** `fetch`, with a network failure reported as an ApiError that names the origin. */
 export async function fetchFrom(fetchImpl, baseUrl, input, init) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeegme/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The Zeeg command line: bookings, availability, notes, CRM, routing forms and AI phone calls from your terminal.",
   "license": "MIT",
   "type": "module",