hymnkeep 0.1.1 → 0.1.3

package/dist/tasks.js

@@ -1,3 +1,4 @@
+import { Upload } from './params.js';
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const DATE = /^\d{4}-\d{2}-\d{2}$/;
 export function today() {
@@ -21,7 +22,10 @@ function pick(items, wanted, name, what) {
         return found[0];
     }
     const names = (found.length > 1 ? found : items).map((item) => `  ${name(item)[0]}`).join('\n');
-    throw new Error(found.length > 1 ? `More than one ${what} matches "${wanted}":\n${names}` : `No ${what} matches "${wanted}". There are:\n${names}`);
+    if (found.length > 1) {
+        throw new Error(`More than one ${what} matches "${wanted}":\n${names}`);
+    }
+    throw new Error(items.length === 0 ? `No ${what} matches "${wanted}".` : `No ${what} matches "${wanted}". There are:\n${names}`);
 }
 export async function whoami(api) {
     const me = await api.get('whoami');
@@ -184,6 +188,9 @@ export async function addSlot(api, options) {
     const targets = services(found, options.services);
     const { data: slots } = await api.get('slots');
     const slot = pick(slots.filter((s) => !s.hidden), options.slot, (s) => [s.name], 'slot name');
+    if (options.preview) {
+        return { data: { slot, services: targets }, text: `Would add ${slot.name}, empty, at ${targets.map((t) => t.display).join(', ')}. Nothing was sent.` };
+    }
     const reply = await api.post(`occasions/${found.id}/day/slots`, { slot_id: slot.id, service_ids: targets.map((t) => t.id) });
     return { data: reply, text: `Added ${slot.name} at ${targets.map((t) => t.display).join(', ')}.` };
 }
@@ -192,9 +199,30 @@ export async function removeSlot(api, options) {
     const found = await day(api, options.when);
     const targets = services(found, options.services);
     const slotName = pick(uniqueSlots(found), options.slot, (s) => [s.name], 'slot').name;
-    const rows = found.music.filter((row) => row.slot === slotName && targets.some((t) => t.id === row.service_id));
+    const rows = [];
+    // One place a service, never more: where a service has the slot twice,
+    // the empty one goes, or the one holding the piece named.
+    for (const service of targets) {
+        const here = found.music.filter((row) => row.slot === slotName && row.service_id === service.id);
+        const held = options.holding ? here.filter((row) => has(row.title, options.holding)) : here;
+        if (here.length === 0 || (options.holding && held.length === 0)) {
+            continue;
+        }
+        const empty = held.filter((row) => !row.piece_id);
+        if (held.length > 1 && empty.length === 0 && new Set(held.map((row) => row.piece_id)).size > 1) {
+            throw new Error(`${service.display} has ${slotName} ${held.length} times: ${held.map((row) => title(row)).join(', ')}. Say which with --holding <piece>.`);
+        }
+        rows.push(empty[0] ?? held[0]);
+    }
+    if (rows.length === 0) {
+        throw new Error(`None of those services has ${slotName}${options.holding ? ` holding ${options.holding}` : ''}.`);
+    }
+    const where = rows.map((row) => `${found.services.find((s) => s.id === row.service_id)?.display}${row.piece_id ? ` (holding ${title(row)})` : ''}`).join(', ');
+    if (options.preview) {
+        return { data: { remove: rows }, text: `Would take ${slotName} off ${where}. Nothing was sent.` };
+    }
     const reply = await api.post(`occasions/${found.id}/day/slots/remove`, { ids: rows.map((row) => row.id) });
-    return { data: reply, text: `Removed ${slotName} from ${rows.map((row) => found.services.find((s) => s.id === row.service_id)?.display).join(', ')}.` };
+    return { data: reply, text: `Took ${slotName} off ${where}.` };
 }
 /** A person in a job, or an ensemble, at every service named: those where someone else does the job have them replaced. */
 export async function assign(api, options) {
@@ -234,13 +262,18 @@ export async function unassign(api, options) {
     for (const service of targets) {
         const rows = (found.people[service.id] ?? []).filter((a) => a.status !== 'cancelled' && same(a.party, options.who) && (!options.job || same(a.job, options.job)));
         for (const row of rows) {
-            await api.delete(`occasions/${found.id}/services/${service.id}/assignments/${row.id}`);
+            if (!options.preview) {
+                await api.delete(`occasions/${found.id}/services/${service.id}/assignments/${row.id}`);
+            }
             gone.push(service.display);
         }
     }
     if (gone.length === 0) {
         throw new Error(`${options.who} is not on ${targets.map((t) => t.display).join(', ')}.`);
     }
+    if (options.preview) {
+        return { data: { remove: gone }, text: `Would take ${options.who} off ${gone.join(', ')}. Nothing was sent.` };
+    }
     return { data: { removed: gone }, text: `Took ${options.who} off ${gone.join(', ')}.` };
 }
 /** One service's music onto another's, replacing it or after it. */
@@ -248,8 +281,21 @@ export async function copy(api, options) {
     const found = await day(api, options.when);
     const [from] = services(found, [options.from]);
     const [to] = services(found, [options.to]);
+    if (options.replace && options.add) {
+        throw new Error('Say --replace or --add, not both.');
+    }
+    // Adding after music that is already there doubles every place both
+    // services have, so a service with music in it waits to be told which.
+    const there = found.music.filter((row) => row.service_id === to.id);
+    if (there.length > 0 && !options.replace && !options.add) {
+        throw new Error(`${to.display} already has music in ${there.length} places. Say --replace to take ${from.display}'s instead, or --add to put it after.`);
+    }
+    const how = options.replace ? ', replacing what it had' : there.length > 0 ? ', after what it had' : '';
+    if (options.preview) {
+        return { data: { from, to, replace: options.replace ?? false }, text: `Would copy ${from.display}'s music to ${to.display}${how}. Nothing was sent.` };
+    }
     const reply = await api.post(`occasions/${found.id}/services/${to.id}/copy`, { from_service_id: from.id, replace: options.replace ?? false });
-    return { data: reply, text: `Copied ${from.display}'s music to ${to.display}${options.replace ? ', replacing what it had' : ''}.` };
+    return { data: reply, text: `Copied ${from.display}'s music to ${to.display}${how}.` };
 }
 /**
  * A date planned from its templates: what they would write, and any question
@@ -286,3 +332,65 @@ export async function plan(api, options) {
     });
     return { data: reply, text: `Planned ${preview.day.name} on ${options.date}.\n\n${describeDay(reply.data)}` };
 }
+/**
+ * Files (PDF or MP3, up to 64 MB) onto a piece in the library: on the piece
+ * itself, or on a step it reads from (its tune, its text, one book's
+ * printing), with the parts each file holds.
+ */
+export async function upload(api, options) {
+    const files = options.files.map((path) => new Upload(path));
+    const bad = files.filter((file) => !['application/pdf', 'audio/mpeg'].includes(file.type));
+    if (bad.length) {
+        throw new Error(`Hymnkeep takes PDF and MP3 files only: ${bad.map((f) => f.name).join(', ')}.`);
+    }
+    const big = files.filter((file) => file.size > 64 * 1024 * 1024);
+    if (big.length) {
+        throw new Error(`Hymnkeep takes files up to 64 MB: ${big.map((f) => f.name).join(', ')} ${big.length === 1 ? 'is' : 'are'} larger.`);
+    }
+    const pieceId = UUID.test(options.piece) ? options.piece : await libraryPiece(api, options.piece);
+    const { data: shown } = await api.get(`music/${pieceId}`);
+    const places = (shown.belongs_to_options ?? []);
+    const place = options.place ? pick(places, options.place, (p) => [p.label, p.value, p.kind], 'place on this piece') : places.find((p) => p.value === 'piece');
+    const parts = options.parts?.length ? await partIds(api, options.parts) : [];
+    const where = `${shown.display_title ?? shown.title}${place && place.value !== 'piece' ? `, on ${place.label.charAt(0).toLowerCase()}${place.label.slice(1)}` : ''}`;
+    const partText = parts.length ? ` as ${parts.map((p) => p.name).join(', ')}` : '';
+    if (options.preview) {
+        return {
+            data: { piece: pieceId, belongs_to: place?.value ?? 'piece', parts: parts.map((p) => p.id), files: files.map((f) => ({ path: f.path, bytes: f.size, type: f.type })) },
+            text: `Would upload ${files.map((f) => f.name).join(', ')} to ${where}${partText}. Nothing was sent.`,
+        };
+    }
+    const added = [];
+    for (const file of files) {
+        const form = new FormData();
+        form.append('file', file.blob(), file.name);
+        if (place) {
+            form.append('belongs_to', String(place.value));
+        }
+        const reply = await api.request('POST', `music/${pieceId}/files`, { form });
+        if (parts.length) {
+            await api.patch(`music/${pieceId}/files/${reply.file_id}`, { part_ids: parts.map((p) => p.id) });
+        }
+        added.push({ id: reply.file_id, name: file.name });
+    }
+    return { data: { piece: pieceId, files: added }, text: `Uploaded ${added.map((f) => f.name).join(', ')} to ${where}${partText}.` };
+}
+/** A piece in the library by its title. A hymn the community has only in a book has no files of its own to take. */
+async function libraryPiece(api, wanted) {
+    const { data } = await api.get('music/library', { q: wanted });
+    try {
+        return pick(data, wanted, (p) => [p.title, p.display_title].filter(Boolean), 'piece in the library').id;
+    }
+    catch (error) {
+        const { data: found } = await api.get('music', { q: wanted });
+        if (found.pieces.some((p) => !p.id && p.work_id)) {
+            throw new Error(`"${wanted}" is in a hymnal but not in your library, and a file needs a piece in the library. Add it to the library in Hymnkeep first.`);
+        }
+        throw error;
+    }
+}
+async function partIds(api, names) {
+    const { data } = await api.get('parts');
+    const live = data.filter((p) => !p.archived);
+    return names.map((name) => pick(live, name, (p) => [p.name], 'part'));
+}