stow-cli 2.1.0 → 2.2.0

package/dist/files-UQODXWNT.js

@@ -0,0 +1,206 @@
+import {
+  parseJsonInput
+} from "./chunk-3BLL5SQJ.js";
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-PLZFHPLC.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatBytes,
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-TOADDO2F.js";
+
+// src/commands/files.ts
+async function listFiles(bucket, options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.listFiles({
+    bucket,
+    ...options.search ? { prefix: options.search } : {},
+    ...parsedLimit && Number.isFinite(parsedLimit) && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.files.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log(`No files in bucket '${bucket}'.`);
+    }
+    return;
+  }
+  if (options.json || isJsonOutput()) {
+    output(data);
+    return;
+  }
+  const rows = data.files.map((f) => [
+    f.key,
+    formatBytes(f.size),
+    f.lastModified.split("T")[0] ?? f.lastModified
+  ]);
+  console.log(formatTable(["Key", "Size", "Modified"], rows));
+  if (data.nextCursor) {
+    console.log("\n(more files available \u2014 use --limit to see more)");
+  }
+}
+async function getFile(bucket, key, _options) {
+  const stow = createStow();
+  const file = await stow.getFile(key, { bucket });
+  output(file, () => {
+    const lines = [
+      formatTable(
+        ["Field", "Value"],
+        [
+          ["Key", file.key],
+          ["Size", formatBytes(file.size)],
+          ["Type", file.contentType],
+          ["Created", file.createdAt],
+          ["URL", file.url ?? "(private)"],
+          [
+            "Dimensions",
+            file.width && file.height ? `${file.width}\xD7${file.height}` : "\u2014"
+          ],
+          ["Duration", file.duration ? `${file.duration}s` : "\u2014"],
+          ["Embedding", file.embeddingStatus ?? "\u2014"]
+        ]
+      )
+    ];
+    if (file.metadata && Object.keys(file.metadata).length > 0) {
+      lines.push("\nMetadata:");
+      for (const [k, v] of Object.entries(file.metadata)) {
+        lines.push(`  ${k}: ${v}`);
+      }
+    }
+    return lines.join("\n");
+  });
+}
+async function updateFile(bucket, key, options) {
+  validateBucketName(bucket);
+  validateFileKey(key);
+  const flagMetadata = {};
+  if (options.metadata && options.metadata.length > 0) {
+    for (const pair of options.metadata) {
+      const idx = pair.indexOf("=");
+      if (idx === -1) {
+        console.error(
+          `Error: Invalid metadata format '${pair}'. Use key=value.`
+        );
+        process.exit(1);
+      }
+      flagMetadata[pair.slice(0, idx)] = pair.slice(idx + 1);
+    }
+  }
+  const jsonInput = parseJsonInput(
+    options.inputJson,
+    {}
+  );
+  const hasFlagMetadata = Object.keys(flagMetadata).length > 0;
+  const metadata = hasFlagMetadata ? { ...jsonInput.metadata ?? {}, ...flagMetadata } : jsonInput.metadata;
+  if (!metadata || Object.keys(metadata).length === 0) {
+    console.error(
+      "Error: At least one -m key=value pair or --input-json with metadata is required."
+    );
+    process.exit(1);
+  }
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "updateFile",
+          details: { bucket, key, metadata }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  const file = await stow.updateFileMetadata(key, metadata, { bucket });
+  output(file, () => `Updated ${key}`);
+}
+async function enrichFile(bucket, key) {
+  const stow = createStow();
+  const results = await Promise.allSettled([
+    stow.generateTitle(key, { bucket }),
+    stow.generateDescription(key, { bucket }),
+    stow.generateAltText(key, { bucket })
+  ]);
+  const labels = ["Title", "Description", "Alt text"];
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i];
+    const label = labels[i];
+    if (result.status === "fulfilled") {
+      console.log(`  ${label}: triggered`);
+    } else {
+      console.error(`  ${label}: failed \u2014 ${result.reason}`);
+    }
+  }
+  const succeeded = results.filter((r) => r.status === "fulfilled").length;
+  console.log(
+    `
+Enriched ${key}: ${succeeded}/${results.length} tasks dispatched`
+  );
+}
+async function listMissing(bucket, type, options) {
+  const validTypes = ["dimensions", "embeddings", "colors"];
+  if (!validTypes.includes(type)) {
+    console.error(
+      `Error: Invalid type '${type}'. Must be one of: ${validTypes.join(", ")}`
+    );
+    process.exit(1);
+  }
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const baseUrl = getBaseUrl();
+  const apiKey = getApiKey();
+  const params = new URLSearchParams({
+    bucket,
+    missing: type,
+    ...parsedLimit && Number.isFinite(parsedLimit) && parsedLimit > 0 ? { limit: String(parsedLimit) } : {}
+  });
+  const res = await fetch(`${baseUrl}/files?${params}`, {
+    headers: { "x-api-key": apiKey }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? `HTTP ${res.status}`);
+  }
+  const data = await res.json();
+  if (data.files.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log(`No files missing ${type} in bucket '${bucket}'.`);
+    }
+    return;
+  }
+  if (options.json || isJsonOutput()) {
+    output(data);
+    return;
+  }
+  const rows = data.files.map((f) => [
+    f.key,
+    formatBytes(f.size),
+    f.lastModified.split("T")[0] ?? f.lastModified
+  ]);
+  console.log(formatTable(["Key", "Size", "Modified"], rows));
+  console.log(`
+${data.files.length} files missing ${type}`);
+}
+export {
+  enrichFile,
+  getFile,
+  listFiles,
+  listMissing,
+  updateFile
+};

package/dist/health-RICGWQGN.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/health.ts
+async function health(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/health"
+  });
+  output(
+    result,
+    () => {
+      const lines = [];
+      const statusIcon = result.status === "ok" ? "+" : "x";
+      lines.push(`${statusIcon} ${result.status} (${result.version})`);
+      lines.push(`  ${result.timestamp}`);
+      lines.push("\nChecks:");
+      for (const [name, status] of Object.entries(result.checks)) {
+        const icon = status === "ok" ? "+" : "x";
+        lines.push(`  ${icon} ${name}`);
+      }
+      if (result.queues) {
+        lines.push("\nQueues:");
+        const rows = [];
+        for (const [name, counts] of Object.entries(result.queues)) {
+          if (counts === "unavailable") {
+            rows.push([name, "--", "--", "--", "--"]);
+          } else {
+            const c = counts;
+            rows.push([
+              name,
+              String(c.waiting ?? 0),
+              String(c.active ?? 0),
+              String(c.completed ?? 0),
+              String(c.failed ?? 0)
+            ]);
+          }
+        }
+        lines.push(
+          formatTable(
+            ["Queue", "Waiting", "Active", "Completed", "Failed"],
+            rows
+          )
+        );
+      }
+      return lines.join("\n");
+    },
+    { json: options.json }
+  );
+}
+export {
+  health
+};

package/dist/jobs-PTV2W5PJ.js

@@ -0,0 +1,102 @@
+import {
+  isJsonOutput,
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-TOADDO2F.js";
+
+// src/commands/jobs.ts
+async function bucketRequest(opts) {
+  const baseUrl = getBaseUrl();
+  const apiKey = getApiKey();
+  const res = await fetch(`${baseUrl}${opts.path}`, {
+    method: opts.method,
+    headers: {
+      "x-api-key": apiKey,
+      ...opts.body ? { "Content-Type": "application/json" } : {}
+    },
+    ...opts.body ? { body: JSON.stringify(opts.body) } : {}
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: res.statusText }));
+    const message = body.error ?? `HTTP ${res.status}`;
+    throw new Error(message);
+  }
+  return await res.json();
+}
+function formatTimestamp(ts) {
+  return new Date(ts).toISOString().replace("T", " ").slice(0, 19);
+}
+async function listJobs(bucketId, options) {
+  const params = new URLSearchParams();
+  if (options.status) {
+    params.set("status", options.status);
+  }
+  if (options.queue) {
+    params.set("queue", options.queue);
+  }
+  if (options.limit) {
+    params.set("limit", options.limit);
+  }
+  const qs = params.toString();
+  const path = `/buckets/${bucketId}/jobs${qs ? `?${qs}` : ""}`;
+  const result = await bucketRequest({
+    method: "GET",
+    path
+  });
+  if (result.jobs.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.jobs);
+    } else {
+      console.log("No jobs found.");
+    }
+    return;
+  }
+  output(
+    result.jobs,
+    () => {
+      const rows = result.jobs.map((job) => [
+        job.jobId,
+        job.queueName,
+        job.status,
+        `${job.data.fileId.slice(0, 8)}...`,
+        formatTimestamp(job.timestamp),
+        job.failedReason ? job.failedReason.slice(0, 40) : ""
+      ]);
+      return formatTable(
+        ["ID", "Queue", "Status", "File", "Created", "Error"],
+        rows
+      );
+    },
+    { json: options.json }
+  );
+}
+async function retryJob(jobId, options) {
+  const result = await bucketRequest({
+    method: "POST",
+    path: `/buckets/${options.bucket}/jobs/${jobId}/retry`,
+    body: { queue: options.queue }
+  });
+  if (result.retried) {
+    console.log(`Job ${jobId} retried.`);
+  }
+}
+async function deleteJob(jobId, options) {
+  const result = await bucketRequest({
+    method: "DELETE",
+    path: `/buckets/${options.bucket}/jobs/${jobId}?queue=${encodeURIComponent(options.queue)}`
+  });
+  if (result.deleted) {
+    console.log(`Job ${jobId} removed.`);
+  }
+}
+export {
+  deleteJob,
+  listJobs,
+  retryJob
+};

package/dist/jobs-ZWSEXNFA.js

@@ -0,0 +1,90 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/jobs.ts
+function formatTimestamp(ts) {
+  return new Date(ts).toISOString().replace("T", " ").slice(0, 19);
+}
+async function listAdminJobs(options) {
+  const params = new URLSearchParams();
+  if (options.org) {
+    params.set("orgId", options.org);
+  }
+  if (options.bucket) {
+    params.set("bucketId", options.bucket);
+  }
+  if (options.status) {
+    params.set("status", options.status);
+  }
+  if (options.queue) {
+    params.set("queue", options.queue);
+  }
+  if (options.limit) {
+    params.set("limit", options.limit);
+  }
+  const qs = params.toString();
+  const result = await adminRequest({
+    method: "GET",
+    path: `/admin/jobs${qs ? `?${qs}` : ""}`
+  });
+  if (result.jobs.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.jobs, void 0, { json: options.json });
+    } else {
+      console.log("No jobs found.");
+    }
+    return;
+  }
+  output(
+    result.jobs,
+    () => {
+      const rows = result.jobs.map((job) => [
+        job.jobId,
+        job.queueName,
+        job.status,
+        `${job.data.fileId.slice(0, 8)}...`,
+        `${job.data.orgId.slice(0, 8)}...`,
+        formatTimestamp(job.timestamp),
+        job.failedReason ? job.failedReason.slice(0, 40) : ""
+      ]);
+      return formatTable(
+        ["ID", "Queue", "Status", "File", "Org", "Created", "Error"],
+        rows
+      );
+    },
+    { json: options.json }
+  );
+}
+async function retryAdminJob(jobId, options) {
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/jobs/${jobId}/retry`,
+    body: { queue: options.queue }
+  });
+  if (result.retried) {
+    console.log(`Job ${jobId} retried.`);
+  }
+}
+async function deleteAdminJob(jobId, options) {
+  const result = await adminRequest({
+    method: "DELETE",
+    path: `/admin/jobs/${jobId}?queue=${encodeURIComponent(options.queue)}`
+  });
+  if (result.deleted) {
+    console.log(`Job ${jobId} removed.`);
+  }
+}
+export {
+  deleteAdminJob,
+  listAdminJobs,
+  retryAdminJob
+};

package/dist/maintenance-ZJW2ES4L.js

@@ -0,0 +1,79 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  output
+} from "./chunk-P2BKGBQE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/maintenance.ts
+async function cleanupDrops(options) {
+  const params = new URLSearchParams();
+  if (options.maxAgeHours) {
+    params.set("maxAgeHours", options.maxAgeHours);
+  }
+  if (options.dryRun) {
+    params.set("dryRun", "true");
+  }
+  const qs = params.toString();
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/cleanup-drops${qs ? `?${qs}` : ""}`
+  });
+  output(
+    result,
+    () => options.dryRun ? `[dry run] Would clean up ${result.count ?? 0} drops` : `Cleaned up ${result.deleted ?? 0} drops`,
+    { json: options.json }
+  );
+}
+async function purgeEvents(options) {
+  const params = new URLSearchParams();
+  if (options.dryRun) {
+    params.set("dryRun", "true");
+  }
+  const qs = params.toString();
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/purge-events${qs ? `?${qs}` : ""}`
+  });
+  output(
+    result,
+    () => options.dryRun ? `[dry run] Would purge ${result.count ?? 0} events` : `Purged ${result.deleted ?? 0} events`,
+    { json: options.json }
+  );
+}
+async function reconcileFiles(options) {
+  const params = new URLSearchParams({ bucketId: options.bucket });
+  if (options.dryRun) {
+    params.set("dryRun", "true");
+  }
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/reconcile-files?${params}`
+  });
+  output(
+    result,
+    () => {
+      if (options.dryRun) {
+        return `[dry run] ${result.mismatched ?? 0} files need reconciliation`;
+      }
+      return `Reconciled ${result.reconciled ?? 0} files`;
+    },
+    { json: options.json }
+  );
+}
+async function retrySyncFailures(options) {
+  const result = await adminRequest({
+    method: "POST",
+    path: "/admin/retry-sync-failures"
+  });
+  output(result, () => `Retried ${result.retried ?? 0} sync failures`, {
+    json: options.json
+  });
+}
+export {
+  cleanupDrops,
+  purgeEvents,
+  reconcileFiles,
+  retrySyncFailures
+};

package/dist/profiles-CHBGKQOE.js

@@ -0,0 +1,53 @@
+import {
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/profiles.ts
+async function createProfile(options) {
+  const stow = createStow();
+  const profile = await stow.profiles.create({
+    name: options.name,
+    ...options.bucket ? { bucketId: options.bucket } : {}
+  });
+  output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
+    json: options.json
+  });
+}
+async function getProfile(id, options) {
+  const stow = createStow();
+  const profile = await stow.profiles.get(id);
+  output(
+    profile,
+    () => {
+      const lines = [`Profile: ${profile.name} (${profile.id})`];
+      if (profile.clusters && profile.clusters.length > 0) {
+        lines.push("\nClusters:");
+        const rows = profile.clusters.map((c) => [
+          String(c.index),
+          c.name ?? "(unnamed)",
+          String(c.signalCount)
+        ]);
+        lines.push(formatTable(["Index", "Name", "Signals"], rows));
+      }
+      return lines.join("\n");
+    },
+    { json: options.json }
+  );
+}
+async function deleteProfile(id) {
+  const stow = createStow();
+  await stow.profiles.delete(id);
+  console.log(`Deleted profile: ${id}`);
+}
+export {
+  createProfile,
+  deleteProfile,
+  getProfile
+};

package/dist/queues-EZ2VZGXQ.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/queues.ts
+async function listQueues(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/admin/queues"
+  });
+  const entries = Object.entries(result.queues);
+  if (entries.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.queues, void 0, { json: options.json });
+    } else {
+      console.log("No queues found.");
+    }
+    return;
+  }
+  output(
+    result.queues,
+    () => {
+      const rows = entries.map(([name, counts]) => [
+        name,
+        String(counts.waiting),
+        String(counts.active),
+        String(counts.completed),
+        String(counts.failed)
+      ]);
+      return formatTable(
+        ["Queue", "Waiting", "Active", "Completed", "Failed"],
+        rows
+      );
+    },
+    { json: options.json }
+  );
+}
+async function cleanQueue(queueName, options) {
+  const status = options.failed ? "failed" : "completed";
+  const grace = options.grace ? Number(options.grace) : 0;
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
+    body: { status, grace }
+  });
+  console.log(
+    `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
+  );
+}
+export {
+  cleanQueue,
+  listQueues
+};