components/media/media-actions.ts

Functions

Imports

It imports no other module of this repo. Imported by components/media/media.react.tsx, components/media/media.ts.

Source

1// The media library's bulk tags and the clipboard: plain functions the behaviour module and the React
2// wrapper share.
3
4// ---------------------------------------------------------------------------------------
5// Bulk tags: add or remove one tag across a
6// selection. An item already in the wanted state is skipped, so it is not rewritten for nothing,
7// and one item's failure is recorded without stopping the rest.
8export async function applyBulkTag<T>({
9  ids,
10  wanted,
11  adding,
12  missing,
13  read,
14  write,
15}: {
16  ids: readonly string[];
17  wanted: string;
18  adding: boolean;
19  missing: string;
20  read: (id: string) => Promise<{ item: T; tags: string[] } | null>;
21  write: (id: string, item: T, tags: string[]) => Promise<unknown>;
22}): Promise<{ done: string[]; skipped: string[]; failed: string[] }> {
23  const failed: string[] = [];
24  const done: string[] = [];
25  const skipped: string[] = [];
26  for (const id of ids) {
27    try {
28      const found = await read(id);
29      if (!found) {
30        failed.push(`${id}: ${missing}`);
31        continue;
32      }
33      if (adding === found.tags.includes(wanted)) {
34        skipped.push(id);
35        continue;
36      }
37      await write(id, found.item, adding ? [...found.tags, wanted] : found.tags.filter((t) => t !== wanted));
38      done.push(id);
39    } catch (error) {
40      failed.push(`${id}: ${error instanceof Error ? error.message : "failed"}`);
41    }
42  }
43  return { done, skipped, failed };
44}
45
46// ---------------------------------------------------------------------------------------
47// The clipboard. Copy through the Clipboard API; where the page may not, through a selected
48// field and the document's own copy command; where neither works, say so and leave the text
49// selected.
50
51// How long the copy status stays: a success is short news, a failure leaves time to copy by hand.
52export const COPIED_MS = 2500;
53export const COPY_FAILED_MS = 8000;
54
55export async function copyText(text: string): Promise<boolean> {
56  try {
57    await navigator.clipboard.writeText(text);
58    return true;
59  } catch {
60    // fall through
61  }
62  try {
63    const area = document.createElement("textarea");
64    area.value = text;
65    area.setAttribute("readonly", "");
66    area.style.setProperty("position", "fixed");
67    area.style.setProperty("opacity", "0");
68    document.body.append(area);
69    area.select();
70    const ok = document.execCommand("copy");
71    area.remove();
72    return ok;
73  } catch {
74    return false;
75  }
76}
77