stow-cli 2.2.0 → 2.2.1

package/dist/files-CFOTEASC.js

@@ -0,0 +1,206 @@
+import {
+  parseJsonInput
+} from "./chunk-3BLL5SQJ.js";
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-PLZFHPLC.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-5BVMPHKH.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/files-XU6MDPP4.js

@@ -0,0 +1,206 @@
+import {
+  parseJsonInput
+} from "./chunk-3BLL5SQJ.js";
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-PLZFHPLC.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-5IX3ASXH.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-SH6T6DZS.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  output
+} from "./chunk-5IX3ASXH.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/health-YLNNKAFP.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  output
+} from "./chunk-5BVMPHKH.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-RMRGXLAA.js

@@ -0,0 +1,90 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-5BVMPHKH.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/jobs-ROJFRPMR.js

@@ -0,0 +1,90 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-5IX3ASXH.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
+};