@indigoai-us/hq-cli 5.55.0 → 5.56.0

package/dist/commands/cloud.d.ts

@@ -15,6 +15,13 @@
 import { Command } from "commander";
 import { type ConflictStrategy, type MembershipSyncConfig, type SyncMode, type PullScope, type ExplicitGrant } from "@indigoai-us/hq-cloud";
 import { type BannerLevel } from "../lib/narrow-hint-banner.js";
+/**
+ * Build a loud, human-readable warning when a push dropped files because
+ * they fell outside the caller's granted write scope. Returns null when
+ * nothing was scope-excluded. Keeping this pure makes the "never silently
+ * succeed when files were dropped" guarantee unit-testable.
+ */
+export declare function scopeExcludedWarning(count: number): string | null;
 export interface PullAllVaultClient {
     listMyMemberships(): Promise<Array<{
         companyUid: string;
@@ -140,6 +147,7 @@ export interface ShareCallResult {
     bytesUploaded: number;
     filesSkipped: number;
     filesDeleted: number;
+    filesExcludedByScope: number;
     conflictPaths: string[];
     aborted: boolean;
 }
@@ -169,6 +177,7 @@ export interface PushAllResult {
     filesUploaded: number;
     bytesUploaded: number;
     filesDeleted: number;
+    filesExcludedByScope: number;
     errors: Array<{
         company: string;
         message: string;

package/dist/commands/cloud.js

@@ -13,13 +13,27 @@
  *   hq sync status            — show local journal summary
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="59cfec0e-76a2-5beb-8eb6-80a129dd62c6")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fa72780b-ae22-5125-98b6-4e7b866b7d17")}catch(e){}}();
 import chalk from "chalk";
 import * as fs from "fs";
 import * as path from "path";
 import { share, sync, getStateDir, listJournals, loadCachedTokens, VaultClient, computePersonalVaultPaths, PERSONAL_VAULT_JOURNAL_SLUG, resolvePullScope, } from "@indigoai-us/hq-cloud";
 import { DEFAULT_HQ_ROOT, ensureCognitoToken, buildVaultConfig, } from "../utils/cognito-session.js";
 import { emitNarrowHint, isStrictRefusal, resolveBannerLevel, } from "../lib/narrow-hint-banner.js";
+/**
+ * Build a loud, human-readable warning when a push dropped files because
+ * they fell outside the caller's granted write scope. Returns null when
+ * nothing was scope-excluded. Keeping this pure makes the "never silently
+ * succeed when files were dropped" guarantee unit-testable.
+ */
+export function scopeExcludedWarning(count) {
+    if (count <= 0)
+        return null;
+    return (`⚠ ${count} file(s) were NOT uploaded — they fall outside the ` +
+        `prefixes you have write access to (company-wide or direct grants). ` +
+        `They were skipped, not synced. Re-run with --json to list them, or ` +
+        `ask an admin to grant you write on those paths.`);
+}
 /**
  * Resolve the `propagateDeletePolicy` for share() calls.
  *
@@ -251,6 +265,7 @@ export async function pushAll(options, deps) {
         filesUploaded: 0,
         bytesUploaded: 0,
         filesDeleted: 0,
+        filesExcludedByScope: 0,
         errors: [],
         perCompany: [],
     };
@@ -261,6 +276,7 @@ export async function pushAll(options, deps) {
             result.filesUploaded += r.filesUploaded;
             result.bytesUploaded += r.bytesUploaded;
             result.filesDeleted += r.filesDeleted;
+            result.filesExcludedByScope += r.filesExcludedByScope;
             result.perCompany.push({ slug: entry.slug, result: r });
         }
         catch (err) {
@@ -621,7 +637,14 @@ export function registerCloudCommands(program) {
                 log(chalk.yellow(`\n⚠ Push aborted (${result.filesUploaded} uploaded, ${result.filesSkipped} skipped)`));
                 process.exit(1);
             }
-            log(chalk.green(`\n✓ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ${result.filesSkipped} skipped)`));
+            if (result.filesExcludedByScope > 0) {
+                log(chalk.yellow(`\n⚠ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ` +
+                    `${result.filesSkipped} skipped, ${result.filesExcludedByScope} scope-excluded)`));
+                log(chalk.yellow(scopeExcludedWarning(result.filesExcludedByScope)));
+            }
+            else {
+                log(chalk.green(`\n✓ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ${result.filesSkipped} skipped)`));
+            }
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
@@ -1051,18 +1074,27 @@ async function runPushAll(hqRoot, message, onConflict, skipPersonal) {
         }
         else if (row.result) {
             const r = row.result;
-            const status = r.aborted ? chalk.yellow("⚠") : chalk.green("✓");
+            const status = r.aborted || r.filesExcludedByScope > 0
+                ? chalk.yellow("⚠")
+                : chalk.green("✓");
             console.log(`  ${status} ${row.slug}: ${r.filesUploaded} file(s), ` +
                 `${formatBytes(r.bytesUploaded)}, ${r.filesSkipped} skipped, ` +
-                `${r.filesDeleted} deleted, ${r.conflictPaths.length} conflict(s)` +
+                `${r.filesDeleted} deleted, ${r.filesExcludedByScope} scope-excluded, ` +
+                `${r.conflictPaths.length} conflict(s)` +
                 (r.aborted ? " — aborted" : ""));
         }
     }
     const errored = result.errors.length;
     const summary = `\nPushed ${result.filesUploaded} file(s) ` +
         `(${formatBytes(result.bytesUploaded)}) across ${result.attempted} ` +
-        `target(s); ${result.filesDeleted} deleted; ${errored} error(s)`;
-    console.log(errored > 0 ? chalk.yellow(summary) : chalk.green(summary));
+        `target(s); ${result.filesDeleted} deleted; ${errored} error(s); ` +
+        `${result.filesExcludedByScope} scope-excluded`;
+    console.log(errored > 0 || result.filesExcludedByScope > 0
+        ? chalk.yellow(summary)
+        : chalk.green(summary));
+    if (result.filesExcludedByScope > 0) {
+        console.log(chalk.yellow(scopeExcludedWarning(result.filesExcludedByScope)));
+    }
     if (errored > 0)
         process.exit(1);
 }
@@ -1124,10 +1156,16 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
             ...(journalSlug !== undefined ? { journalSlug } : {}),
             ...(author ? { author } : {}),
         });
-        console.log(`    ${pushResult.aborted ? chalk.yellow("⚠") : chalk.green("✓")} ` +
+        const pushStatus = pushResult.aborted || pushResult.filesExcludedByScope > 0
+            ? chalk.yellow("⚠")
+            : chalk.green("✓");
+        console.log(`    ${pushStatus} ` +
             `${pushResult.filesUploaded} uploaded, ${pushResult.filesSkipped} skipped, ` +
-            `${pushResult.filesDeleted} deleted` +
+            `${pushResult.filesDeleted} deleted, ${pushResult.filesExcludedByScope} scope-excluded` +
             (pushResult.aborted ? " — aborted" : ""));
+        if (pushResult.filesExcludedByScope > 0) {
+            console.log(chalk.yellow(scopeExcludedWarning(pushResult.filesExcludedByScope)));
+        }
         if (pushResult.aborted) {
             console.log(chalk.yellow("\n⚠ Sync now aborted on push leg; pull skipped."));
             process.exit(1);
@@ -1330,4 +1368,4 @@ function resolveUploadAuthorFromCache() {
     }
 }
 //# sourceMappingURL=cloud.js.map
-//# debugId=59cfec0e-76a2-5beb-8eb6-80a129dd62c6
+//# debugId=fa72780b-ae22-5125-98b6-4e7b866b7d17

package/dist/commands/meetings.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ae9ed929-9821-5f8b-bbbe-8f7b6105f5ad")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2640a391-a3e6-5830-b56f-03b5fab3a4bd")}catch(e){}}();
 import chalk from "chalk";
 import { ensureCognitoToken } from "../utils/cognito-session.js";
 import { vaultApiFetch, getCompanyUid } from "../utils/vault-api.js";
@@ -35,9 +35,14 @@ function statusBadge(status) {
 async function resolveShortId(token, prefix, query) {
     if (prefix.includes("-") && prefix.length > 8)
         return prefix;
-    const res = await vaultApiFetch({ token, path: "/v1/meetings", query });
-    if (!res.ok)
-        return prefix;
+    const res = await vaultApiFetch({
+        token,
+        path: "/v1/meetings",
+        query: { ...query, limit: "500" },
+    });
+    if (!res.ok) {
+        throw new Error(`Could not resolve meeting ID "${prefix}" — failed to list meetings (${res.status}). Pass the full meeting id.`);
+    }
     const data = (await res.json());
     const matches = data.meetings.filter((m) => m.meetingId.startsWith(prefix));
     if (matches.length === 1)
@@ -46,7 +51,8 @@ async function resolveShortId(token, prefix, query) {
         console.error(chalk.red(`Ambiguous ID prefix "${prefix}" — matches ${matches.length} meetings. Use a longer prefix.`));
         process.exit(1);
     }
-    return prefix;
+    console.error(chalk.red(`No meeting matches ID "${prefix}". It may be older than the meetings shown by \`hq meetings list\`, still processing, or attributed to a different company. Pass the full meeting id, add --company <slug>, or widen the list with \`hq meetings list --limit <n>\`.`));
+    process.exit(1);
 }
 async function handleApiError(res) {
     const body = (await res.json().catch(() => ({})));
@@ -426,4 +432,4 @@ export function registerMeetingsCommand(program) {
     });
 }
 //# sourceMappingURL=meetings.js.map
-//# debugId=ae9ed929-9821-5f8b-bbbe-8f7b6105f5ad
+//# debugId=2640a391-a3e6-5830-b56f-03b5fab3a4bd

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.55.0",
+  "version": "5.56.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {

package/src/commands/cloud.push-all.test.ts

@@ -82,6 +82,7 @@ function makeShareSpy(
         bytesUploaded: 0,
         filesSkipped: 0,
         filesDeleted: 0,
+        filesExcludedByScope: 0,
         conflictPaths: [],
         aborted: false,
         ...override,
@@ -307,6 +308,7 @@ describe("pushAll", () => {
       filesUploaded: 0,
       bytesUploaded: 0,
       filesDeleted: 0,
+      filesExcludedByScope: 0,
       errors: [],
       perCompany: [],
     });
@@ -379,6 +381,33 @@ describe("pushAll", () => {
     expect(result.filesDeleted).toBe(4);
   });
 
+  it("aggregates filesExcludedByScope across every successful target", async () => {
+    const hqRoot = makeHqRoot(["companies", "docs"]);
+    const vaultClient = makeVaultClient({
+      memberships: [{ companyUid: "cmp_acme" }],
+      persons: [
+        {
+          uid: "psn_alice",
+          type: "person",
+          slug: "alice",
+          createdAt: "2026-01-01T00:00:00Z",
+        },
+      ],
+      entitiesBySlug: { cmp_acme: { slug: "acme" } },
+    });
+    const share = makeShareSpy({
+      cmp_acme: { filesExcludedByScope: 2 },
+      psn_alice: { filesExcludedByScope: 3 },
+    });
+
+    const result = await pushAll(
+      { hqRoot },
+      { vaultClient, share: share.fn },
+    );
+
+    expect(result.filesExcludedByScope).toBe(5);
+  });
+
   // ── skipPersonal — fanout omits the canonical-person leg ──────────────────
   //
   // Symmetric with the `pullAll` skipPersonal coverage in

package/src/commands/cloud.scope-excluded-warning.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from "vitest";
+
+import { scopeExcludedWarning } from "./cloud.js";
+
+describe("scopeExcludedWarning", () => {
+  it("returns null for zero and negative counts", () => {
+    expect(scopeExcludedWarning(0)).toBeNull();
+    expect(scopeExcludedWarning(-1)).toBeNull();
+  });
+
+  it("returns a loud warning for positive counts", () => {
+    const warning = scopeExcludedWarning(3);
+
+    expect(warning).toBeTruthy();
+    expect(warning).toContain("3");
+    // The warning must loudly state the files did NOT reach the vault and
+    // explain why (outside the caller's write access) — without leaning on
+    // the jargon word "scope" in user-facing copy.
+    expect(warning).toContain("NOT uploaded");
+    expect(warning?.toLowerCase()).toContain("write access");
+  });
+});

package/src/commands/cloud.ts

@@ -50,6 +50,22 @@ import {
   type BannerLevel,
 } from "../lib/narrow-hint-banner.js";
 
+/**
+ * Build a loud, human-readable warning when a push dropped files because
+ * they fell outside the caller's granted write scope. Returns null when
+ * nothing was scope-excluded. Keeping this pure makes the "never silently
+ * succeed when files were dropped" guarantee unit-testable.
+ */
+export function scopeExcludedWarning(count: number): string | null {
+  if (count <= 0) return null;
+  return (
+    `⚠ ${count} file(s) were NOT uploaded — they fall outside the ` +
+    `prefixes you have write access to (company-wide or direct grants). ` +
+    `They were skipped, not synced. Re-run with --json to list them, or ` +
+    `ask an admin to grant you write on those paths.`
+  );
+}
+
 /**
  * Resolve the `propagateDeletePolicy` for share() calls.
  *
@@ -234,6 +250,7 @@ export interface ShareCallResult {
   bytesUploaded: number;
   filesSkipped: number;
   filesDeleted: number;
+  filesExcludedByScope: number;
   conflictPaths: string[];
   aborted: boolean;
 }
@@ -267,6 +284,7 @@ export interface PushAllResult {
   filesUploaded: number;
   bytesUploaded: number;
   filesDeleted: number;
+  filesExcludedByScope: number;
   errors: Array<{ company: string; message: string }>;
   perCompany: PushAllRow[];
 }
@@ -513,6 +531,7 @@ export async function pushAll(
     filesUploaded: 0,
     bytesUploaded: 0,
     filesDeleted: 0,
+    filesExcludedByScope: 0,
     errors: [],
     perCompany: [],
   };
@@ -524,6 +543,7 @@ export async function pushAll(
       result.filesUploaded += r.filesUploaded;
       result.bytesUploaded += r.bytesUploaded;
       result.filesDeleted += r.filesDeleted;
+      result.filesExcludedByScope += r.filesExcludedByScope;
       result.perCompany.push({ slug: entry.slug, result: r });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -1016,11 +1036,21 @@ export function registerCloudCommands(program: Command): void {
             process.exit(1);
           }
 
-          log(
-            chalk.green(
-              `\n✓ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ${result.filesSkipped} skipped)`,
-            ),
-          );
+          if (result.filesExcludedByScope > 0) {
+            log(
+              chalk.yellow(
+                `\n⚠ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ` +
+                  `${result.filesSkipped} skipped, ${result.filesExcludedByScope} scope-excluded)`,
+              ),
+            );
+            log(chalk.yellow(scopeExcludedWarning(result.filesExcludedByScope)!));
+          } else {
+            log(
+              chalk.green(
+                `\n✓ Pushed ${result.filesUploaded} file(s) (${formatBytes(result.bytesUploaded)}, ${result.filesSkipped} skipped)`,
+              ),
+            );
+          }
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
           if (jsonMode) {
@@ -1657,11 +1687,15 @@ async function runPushAll(
       console.log(chalk.red(`  ✗ ${row.slug}: ${row.error}`));
     } else if (row.result) {
       const r = row.result;
-      const status = r.aborted ? chalk.yellow("⚠") : chalk.green("✓");
+      const status =
+        r.aborted || r.filesExcludedByScope > 0
+          ? chalk.yellow("⚠")
+          : chalk.green("✓");
       console.log(
         `  ${status} ${row.slug}: ${r.filesUploaded} file(s), ` +
           `${formatBytes(r.bytesUploaded)}, ${r.filesSkipped} skipped, ` +
-          `${r.filesDeleted} deleted, ${r.conflictPaths.length} conflict(s)` +
+          `${r.filesDeleted} deleted, ${r.filesExcludedByScope} scope-excluded, ` +
+          `${r.conflictPaths.length} conflict(s)` +
           (r.aborted ? " — aborted" : ""),
       );
     }
@@ -1671,8 +1705,16 @@ async function runPushAll(
   const summary =
     `\nPushed ${result.filesUploaded} file(s) ` +
     `(${formatBytes(result.bytesUploaded)}) across ${result.attempted} ` +
-    `target(s); ${result.filesDeleted} deleted; ${errored} error(s)`;
-  console.log(errored > 0 ? chalk.yellow(summary) : chalk.green(summary));
+    `target(s); ${result.filesDeleted} deleted; ${errored} error(s); ` +
+    `${result.filesExcludedByScope} scope-excluded`;
+  console.log(
+    errored > 0 || result.filesExcludedByScope > 0
+      ? chalk.yellow(summary)
+      : chalk.green(summary),
+  );
+  if (result.filesExcludedByScope > 0) {
+    console.log(chalk.yellow(scopeExcludedWarning(result.filesExcludedByScope)!));
+  }
   if (errored > 0) process.exit(1);
 }
 
@@ -1747,12 +1789,19 @@ async function runNowSingle(
       ...(journalSlug !== undefined ? { journalSlug } : {}),
       ...(author ? { author } : {}),
     });
+    const pushStatus =
+      pushResult.aborted || pushResult.filesExcludedByScope > 0
+        ? chalk.yellow("⚠")
+        : chalk.green("✓");
     console.log(
-      `    ${pushResult.aborted ? chalk.yellow("⚠") : chalk.green("✓")} ` +
+      `    ${pushStatus} ` +
         `${pushResult.filesUploaded} uploaded, ${pushResult.filesSkipped} skipped, ` +
-        `${pushResult.filesDeleted} deleted` +
+        `${pushResult.filesDeleted} deleted, ${pushResult.filesExcludedByScope} scope-excluded` +
         (pushResult.aborted ? " — aborted" : ""),
     );
+    if (pushResult.filesExcludedByScope > 0) {
+      console.log(chalk.yellow(scopeExcludedWarning(pushResult.filesExcludedByScope)!));
+    }
     if (pushResult.aborted) {
       console.log(chalk.yellow("\n⚠ Sync now aborted on push leg; pull skipped."));
       process.exit(1);

package/src/commands/meetings.test.ts

@@ -65,6 +65,85 @@ function jsonRes(body: unknown, status = 200): Response {
   });
 }
 
+describe("meetings get — short id resolution", () => {
+  it("resolves an 8-char short id to the full id before calling the by-id endpoint", async () => {
+    const fullId = "589bfd78-aaaa-bbbb-cccc-1234567890ab";
+    vi.mocked(vaultApiFetch)
+      .mockResolvedValueOnce(
+        jsonRes({
+          meetings: [
+            {
+              meetingId: fullId,
+              title: "T",
+              status: "ready",
+              startTime: "2026-01-01T00:00:00Z",
+              endTime: "2026-01-01T00:00:00Z",
+              duration: 0,
+              participantCount: 0,
+              hasTranscript: false,
+              hasNotes: false,
+            },
+          ],
+        }),
+      )
+      .mockResolvedValueOnce(
+        jsonRes({
+          meetingId: fullId,
+          title: "T",
+          startTime: "2026-01-01T00:00:00Z",
+          endTime: "2026-01-01T00:00:00Z",
+          duration: 0,
+          participants: [],
+          calendarEventId: null,
+          botProvider: "recall",
+          sourceApp: "calendar",
+          companyId: "cmp_acme",
+          status: "ready",
+          recallBotId: null,
+          isShared: false,
+          createdAt: "2026-01-01T00:00:00Z",
+          updatedAt: "2026-01-01T00:00:00Z",
+          documentUrl: "",
+          hasTranscript: false,
+          hasNotes: false,
+        }),
+      );
+
+    const program = buildProgram();
+    await program.parseAsync(["node", "hq", "meetings", "get", "589bfd78"]);
+
+    expect(vaultApiFetch).toHaveBeenNthCalledWith(1, {
+      token: "test-token",
+      path: "/v1/meetings",
+      query: { limit: "500" },
+    });
+    expect(vaultApiFetch).toHaveBeenNthCalledWith(2, {
+      token: "test-token",
+      path: `/v1/meetings/${fullId}`,
+      query: {},
+    });
+  });
+
+  it("errors and never sends the truncated id when the short id matches no meeting", async () => {
+    vi.spyOn(process, "exit").mockImplementation((() => {
+      throw new Error("process.exit");
+    }) as never);
+    vi.mocked(vaultApiFetch).mockResolvedValueOnce(jsonRes({ meetings: [] }));
+
+    const program = buildProgram();
+    await expect(
+      program.parseAsync(["node", "hq", "meetings", "get", "589bfd78"]),
+    ).rejects.toThrow("process.exit");
+
+    expect(errSpy).toHaveBeenCalledWith(
+      expect.stringContaining("No meeting matches ID \"589bfd78\""),
+    );
+    expect(vaultApiFetch).not.toHaveBeenCalledWith(
+      expect.objectContaining({ path: "/v1/meetings/589bfd78" }),
+    );
+  });
+});
+
 describe("meetings set-company", () => {
   it("POSTs the resolved company id and applies to the recurring series by default", async () => {
     vi.mocked(vaultApiFetch).mockResolvedValueOnce(

package/src/commands/meetings.ts

@@ -105,8 +105,16 @@ async function resolveShortId(
   query: Record<string, string>,
 ): Promise<string> {
   if (prefix.includes("-") && prefix.length > 8) return prefix;
-  const res = await vaultApiFetch({ token, path: "/v1/meetings", query });
-  if (!res.ok) return prefix;
+  const res = await vaultApiFetch({
+    token,
+    path: "/v1/meetings",
+    query: { ...query, limit: "500" },
+  });
+  if (!res.ok) {
+    throw new Error(
+      `Could not resolve meeting ID "${prefix}" — failed to list meetings (${res.status}). Pass the full meeting id.`,
+    );
+  }
   const data = (await res.json()) as { meetings: MeetingListItem[] };
   const matches = data.meetings.filter((m) => m.meetingId.startsWith(prefix));
   if (matches.length === 1) return matches[0].meetingId;
@@ -114,7 +122,12 @@ async function resolveShortId(
     console.error(chalk.red(`Ambiguous ID prefix "${prefix}" — matches ${matches.length} meetings. Use a longer prefix.`));
     process.exit(1);
   }
-  return prefix;
+  console.error(
+    chalk.red(
+      `No meeting matches ID "${prefix}". It may be older than the meetings shown by \`hq meetings list\`, still processing, or attributed to a different company. Pass the full meeting id, add --company <slug>, or widen the list with \`hq meetings list --limit <n>\`.`,
+    ),
+  );
+  process.exit(1);
 }
 
 async function handleApiError(res: Response): Promise<never> {