cutsio 0.2.4 → 0.2.6

package/dist/index.js

@@ -137,6 +137,18 @@ var ApiError = class extends Error {
     this.status = status;
   }
 };
+var MAX_REQUEST_RETRIES = 3;
+var BASE_RETRY_DELAY_MS = 1e3;
+var MAX_RETRY_DELAY_MS = 3e4;
+function retryDelayMs(attempt, retryAfter) {
+  const headerSeconds = retryAfter ? Number(retryAfter) : Number.NaN;
+  const headerMs = Number.isFinite(headerSeconds) && headerSeconds >= 0 ? headerSeconds * 1e3 : null;
+  const backoffMs = Math.min(BASE_RETRY_DELAY_MS * 2 ** attempt, MAX_RETRY_DELAY_MS);
+  return Math.min(headerMs ?? backoffMs, MAX_RETRY_DELAY_MS) + Math.random() * 500;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 var CutsioClient = class {
   base;
   apiKey;
@@ -181,17 +193,21 @@ var CutsioClient = class {
       ...init?.body ? { "Content-Type": "application/json" } : {},
       ...init?.headers ?? {}
     };
-    const response = await fetch(`${this.base}${path}`, { ...init, headers });
-    if (!response.ok) {
-      let message = `HTTP ${response.status}`;
-      try {
-        const body = await response.json();
-        if (typeof body.error === "string") message = body.error;
-      } catch {
+    for (let attempt = 0; ; attempt += 1) {
+      const response = await fetch(`${this.base}${path}`, { ...init, headers });
+      if (response.ok) return response.json();
+      const retryable = response.status === 429 || response.status === 502 || response.status === 503 || response.status === 504;
+      if (!retryable || attempt >= MAX_REQUEST_RETRIES) {
+        let message = `HTTP ${response.status}`;
+        try {
+          const body = await response.json();
+          if (typeof body.error === "string") message = body.error;
+        } catch {
+        }
+        throw new ApiError(message, response.status);
       }
-      throw new ApiError(message, response.status);
+      await sleep(retryDelayMs(attempt, response.headers.get("retry-after")));
     }
-    return response.json();
   }
 };
 
@@ -350,6 +366,195 @@ function resolveSelection(manifest, selection) {
   return { videos: [...selected.values()], errors };
 }
 
+// src/ui/format.ts
+function formatBytes(bytes) {
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  let value = bytes;
+  let unit = 0;
+  while (value >= 1024 && unit < units.length - 1) {
+    value /= 1024;
+    unit += 1;
+  }
+  return `${value.toFixed(unit === 0 ? 0 : 1)} ${units[unit]}`;
+}
+
+// src/ui/theme.ts
+var colorEnabled = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+function paint(code) {
+  return colorEnabled ? (text) => `\x1B[${code}m${text}\x1B[0m` : (text) => text;
+}
+var color = {
+  dim: paint(2),
+  bold: paint(1),
+  red: paint(31),
+  green: paint(32),
+  yellow: paint(33),
+  blue: paint(34),
+  magenta: paint(35),
+  cyan: paint(36)
+};
+var isInteractive = colorEnabled;
+var animationsEnabled = colorEnabled && process.env.CUTSIO_NO_ANIM !== "1";
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/ui/progress.ts
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var BAR_WIDTH = 22;
+var ProgressView = class {
+  active = /* @__PURE__ */ new Map();
+  interactive = isInteractive;
+  statusLine = null;
+  renderedLines = 0;
+  frame = 0;
+  timer = null;
+  dirty = false;
+  constructor() {
+    if (!this.interactive) return;
+    this.timer = setInterval(() => {
+      if (this.active.size === 0 && !this.statusLine) return;
+      this.frame += 1;
+      this.render();
+    }, 120);
+    this.timer.unref();
+  }
+  status(text) {
+    if (!this.interactive) return;
+    this.statusLine = text;
+    this.dirty = true;
+    this.render();
+  }
+  /** Print a line above the live area without tearing it. */
+  log(message) {
+    if (!this.interactive) {
+      console.log(message);
+      return;
+    }
+    this.clear();
+    process.stdout.write(`${message}
+`);
+    this.render();
+  }
+  error(message) {
+    if (!this.interactive) {
+      console.error(message);
+      return;
+    }
+    this.clear();
+    process.stderr.write(`${message}
+`);
+    this.render();
+  }
+  start(id, label) {
+    if (!this.interactive) {
+      console.log(`  fetch   ${label}`);
+      return;
+    }
+    const now = Date.now();
+    this.active.set(id, {
+      label,
+      bytes: 0,
+      total: null,
+      lastBytes: 0,
+      lastAt: now,
+      speed: 0
+    });
+    this.dirty = true;
+    this.render();
+  }
+  progress(id, bytes, total) {
+    if (!this.interactive) return;
+    const item = this.active.get(id);
+    if (!item) return;
+    const now = Date.now();
+    const elapsed = (now - item.lastAt) / 1e3;
+    if (elapsed >= 0.3) {
+      const delta = bytes - item.lastBytes;
+      if (delta >= 0) item.speed = delta / elapsed;
+      item.lastBytes = bytes;
+      item.lastAt = now;
+    }
+    item.bytes = bytes;
+    if (total !== null) item.total = total;
+    this.dirty = true;
+  }
+  finish(id, ok, text) {
+    if (!this.interactive) {
+      if (ok) console.log(`  done    ${text}`);
+      else console.error(`  FAILED  ${text}`);
+      return;
+    }
+    this.clear();
+    const line = ok ? `  ${color.green("\u2713")} ${text}` : `  ${color.red("\u2717")} ${text}`;
+    (ok ? process.stdout : process.stderr).write(`${line}
+`);
+    this.active.delete(id);
+    this.render();
+  }
+  stop() {
+    if (this.timer) clearInterval(this.timer);
+    this.timer = null;
+    if (!this.interactive) return;
+    this.clear();
+    this.active.clear();
+    this.statusLine = null;
+  }
+  /** Run `work` while a spinner status shows; cleared on exit, plain line when piped. */
+  async withStatus(text, work) {
+    if (!this.interactive) {
+      console.log(text);
+      try {
+        return await work();
+      } finally {
+        this.stop();
+      }
+    }
+    this.status(text);
+    try {
+      return await work();
+    } finally {
+      this.statusLine = null;
+      this.render();
+    }
+  }
+  clear() {
+    if (this.renderedLines === 0) return;
+    process.stdout.write(`\x1B[${this.renderedLines}A\x1B[J`);
+    this.renderedLines = 0;
+  }
+  render() {
+    if (!this.interactive) return;
+    if (this.active.size === 0 && !this.statusLine) {
+      this.clear();
+      return;
+    }
+    const lines = [];
+    if (this.statusLine) {
+      const spinner = FRAMES[this.frame % FRAMES.length] ?? FRAMES[0];
+      lines.push(`  ${color.cyan(spinner ?? "")} ${color.dim(this.statusLine)}`);
+    }
+    for (const item of this.active.values()) {
+      lines.push(`    ${color.bold(item.label)}`);
+      lines.push(`    ${this.bar(item)}`);
+    }
+    this.clear();
+    process.stdout.write(`${lines.join("\n")}
+`);
+    this.renderedLines = lines.length;
+    this.dirty = false;
+  }
+  bar(item) {
+    const ratio = item.total && item.total > 0 ? Math.min(1, item.bytes / item.total) : null;
+    const filled = ratio === null ? 0 : Math.round(ratio * BAR_WIDTH);
+    const track = color.cyan("\u2588".repeat(filled)) + color.dim("\u2591".repeat(BAR_WIDTH - filled));
+    const percent = ratio === null ? "  ? " : `${Math.floor(ratio * 100)}%`.padStart(4);
+    const size = item.total ? `${formatBytes(item.bytes)} / ${formatBytes(item.total)}` : formatBytes(item.bytes);
+    const speed = item.speed > 0 ? `${formatBytes(item.speed)}/s` : "";
+    return `${track} ${percent}  ${size}  ${color.dim(speed)}`.trimEnd();
+  }
+};
+
 // src/commands/list.ts
 async function listCommand(flags) {
   const { apiKey, migrated } = await resolveApiKey();
@@ -359,12 +564,15 @@ async function listCommand(flags) {
     return 1;
   }
   const client = new CutsioClient(resolveApiUrl(flags.url), apiKey);
+  const view = new ProgressView();
   let manifest;
   try {
-    manifest = await client.fetchManifest();
+    manifest = await view.withStatus("Fetching workspace\u2026", () => client.fetchManifest());
   } catch (error) {
     console.error(error instanceof Error ? error.message : String(error));
     return 1;
+  } finally {
+    view.stop();
   }
   if (flags.json === "true") {
     console.log(JSON.stringify(manifest, null, 2));
@@ -446,7 +654,16 @@ async function loginCommand(flags) {
       continue;
     }
     try {
-      const who = await new CutsioClient(apiUrl, apiKey).whoami();
+      const view = new ProgressView();
+      let who;
+      try {
+        who = await view.withStatus(
+          "Verifying key\u2026",
+          () => new CutsioClient(apiUrl, apiKey).whoami()
+        );
+      } finally {
+        view.stop();
+      }
       if (!who.orgId) {
         console.error("That key is not attached to an organization. Create an organization API key.\n");
         continue;
@@ -751,12 +968,16 @@ async function sync(client, options) {
   while (queue.size > 0) {
     const ready = [];
     const ids = [...queue.keys()];
+    let serverDelayMs = 0;
     for (let index = 0; index < ids.length; index += PREPARE_BATCH_SIZE) {
       const batch = ids.slice(index, index + PREPARE_BATCH_SIZE);
       const results = await client.prepare(batch);
       for (const result of results) {
         const item = queue.get(result.id);
         if (!item) continue;
+        if (typeof result.retryAfterSeconds === "number" && result.retryAfterSeconds > 0) {
+          serverDelayMs = Math.max(serverDelayMs, result.retryAfterSeconds * 1e3);
+        }
         switch (result.status) {
           case "ready":
             if (result.url) {
@@ -850,7 +1071,7 @@ async function sync(client, options) {
       }
       break;
     }
-    await sleep(prepareDelayMs);
+    await sleep3(Math.min(Math.max(serverDelayMs, prepareDelayMs), MAX_PREPARE_DELAY_MS));
     prepareDelayMs = Math.min(prepareDelayMs * 2, MAX_PREPARE_DELAY_MS);
   }
   return { downloaded, unchanged, skipped, failed };
@@ -870,180 +1091,10 @@ async function runPool(items, concurrency, worker) {
     })
   );
 }
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-// src/ui/format.ts
-function formatBytes(bytes) {
-  const units = ["B", "KB", "MB", "GB", "TB"];
-  let value = bytes;
-  let unit = 0;
-  while (value >= 1024 && unit < units.length - 1) {
-    value /= 1024;
-    unit += 1;
-  }
-  return `${value.toFixed(unit === 0 ? 0 : 1)} ${units[unit]}`;
-}
-
-// src/ui/theme.ts
-var colorEnabled = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
-function paint(code) {
-  return colorEnabled ? (text) => `\x1B[${code}m${text}\x1B[0m` : (text) => text;
-}
-var color = {
-  dim: paint(2),
-  bold: paint(1),
-  red: paint(31),
-  green: paint(32),
-  yellow: paint(33),
-  blue: paint(34),
-  magenta: paint(35),
-  cyan: paint(36)
-};
-var isInteractive = colorEnabled;
-var animationsEnabled = colorEnabled && process.env.CUTSIO_NO_ANIM !== "1";
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-// src/ui/progress.ts
-var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
-var BAR_WIDTH = 22;
-var ProgressView = class {
-  active = /* @__PURE__ */ new Map();
-  interactive = isInteractive;
-  statusLine = null;
-  renderedLines = 0;
-  frame = 0;
-  timer = null;
-  dirty = false;
-  constructor() {
-    if (!this.interactive) return;
-    this.timer = setInterval(() => {
-      if (this.active.size === 0) return;
-      this.frame += 1;
-      this.render();
-    }, 120);
-    this.timer.unref();
-  }
-  status(text) {
-    if (!this.interactive) return;
-    this.statusLine = text;
-    this.dirty = true;
-  }
-  /** Print a line above the live area without tearing it. */
-  log(message) {
-    if (!this.interactive) {
-      console.log(message);
-      return;
-    }
-    this.clear();
-    process.stdout.write(`${message}
-`);
-    this.render();
-  }
-  error(message) {
-    if (!this.interactive) {
-      console.error(message);
-      return;
-    }
-    this.clear();
-    process.stderr.write(`${message}
-`);
-    this.render();
-  }
-  start(id, label) {
-    if (!this.interactive) {
-      console.log(`  fetch   ${label}`);
-      return;
-    }
-    const now = Date.now();
-    this.active.set(id, {
-      label,
-      bytes: 0,
-      total: null,
-      lastBytes: 0,
-      lastAt: now,
-      speed: 0
-    });
-    this.dirty = true;
-    this.render();
-  }
-  progress(id, bytes, total) {
-    if (!this.interactive) return;
-    const item = this.active.get(id);
-    if (!item) return;
-    const now = Date.now();
-    const elapsed = (now - item.lastAt) / 1e3;
-    if (elapsed >= 0.3) {
-      const delta = bytes - item.lastBytes;
-      if (delta >= 0) item.speed = delta / elapsed;
-      item.lastBytes = bytes;
-      item.lastAt = now;
-    }
-    item.bytes = bytes;
-    if (total !== null) item.total = total;
-    this.dirty = true;
-  }
-  finish(id, ok, text) {
-    if (!this.interactive) {
-      if (ok) console.log(`  done    ${text}`);
-      else console.error(`  FAILED  ${text}`);
-      return;
-    }
-    this.clear();
-    const line = ok ? `  ${color.green("\u2713")} ${text}` : `  ${color.red("\u2717")} ${text}`;
-    (ok ? process.stdout : process.stderr).write(`${line}
-`);
-    this.active.delete(id);
-    this.render();
-  }
-  stop() {
-    if (this.timer) clearInterval(this.timer);
-    this.timer = null;
-    if (!this.interactive) return;
-    this.clear();
-    this.active.clear();
-    this.statusLine = null;
-  }
-  clear() {
-    if (this.renderedLines === 0) return;
-    process.stdout.write(`\x1B[${this.renderedLines}A\x1B[J`);
-    this.renderedLines = 0;
-  }
-  render() {
-    if (!this.interactive) return;
-    if (this.active.size === 0 && !this.statusLine) {
-      this.clear();
-      return;
-    }
-    const lines = [];
-    if (this.statusLine) {
-      const spinner = FRAMES[this.frame % FRAMES.length] ?? FRAMES[0];
-      lines.push(`  ${color.cyan(spinner ?? "")} ${color.dim(this.statusLine)}`);
-    }
-    for (const item of this.active.values()) {
-      lines.push(`    ${color.bold(item.label)}`);
-      lines.push(`    ${this.bar(item)}`);
-    }
-    this.clear();
-    process.stdout.write(`${lines.join("\n")}
-`);
-    this.renderedLines = lines.length;
-    this.dirty = false;
-  }
-  bar(item) {
-    const ratio = item.total && item.total > 0 ? Math.min(1, item.bytes / item.total) : null;
-    const filled = ratio === null ? 0 : Math.round(ratio * BAR_WIDTH);
-    const track = color.cyan("\u2588".repeat(filled)) + color.dim("\u2591".repeat(BAR_WIDTH - filled));
-    const percent = ratio === null ? "  ? " : `${Math.floor(ratio * 100)}%`.padStart(4);
-    const size = item.total ? `${formatBytes(item.bytes)} / ${formatBytes(item.total)}` : formatBytes(item.bytes);
-    const speed = item.speed > 0 ? `${formatBytes(item.speed)}/s` : "";
-    return `${track} ${percent}  ${size}  ${color.dim(speed)}`.trimEnd();
-  }
-};
-
 // src/commands/selection-prompt.ts
 import { stdin as stdin2, stdout as stdout2 } from "node:process";
 import { createInterface } from "node:readline/promises";
@@ -1172,7 +1223,7 @@ async function syncCommand(flags) {
   try {
     if (flags.interactive === "true") {
       view.stop();
-      manifest = await client.fetchManifest();
+      manifest = await view.withStatus("Fetching workspace\u2026", () => client.fetchManifest());
       const prompted = await promptSelection(manifest);
       if (!prompted) {
         console.log("Cancelled. Nothing downloaded.");
@@ -1280,12 +1331,17 @@ async function whoamiCommand(flags) {
     return 1;
   }
   const client = new CutsioClient(resolveApiUrl(flags.url), apiKey);
+  const view = new ProgressView();
   try {
-    console.log(JSON.stringify(await client.whoami(), null, 2));
+    console.log(
+      JSON.stringify(await view.withStatus("Checking key\u2026", () => client.whoami()), null, 2)
+    );
     return 0;
   } catch (error) {
     console.error(error instanceof Error ? error.message : String(error));
     return 1;
+  } finally {
+    view.stop();
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cutsio",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Sync Cutsio mezzanine masters to a local folder",
   "homepage": "https://cutsio.com",
   "type": "module",