stow-cli 1.0.1 → 1.0.3

package/dist/files-OCYICIAM.js

@@ -0,0 +1,165 @@
+import {
+  formatBytes,
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import {
+  createStow
+} from "./chunk-JYOMHKFS.js";
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-OZ7QQTIZ.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 (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.files.length === 0) {
+    console.log(`No files in bucket '${bucket}'.`);
+    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 });
+  if (options.json) {
+    outputJson(file);
+    return;
+  }
+  console.log(
+    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) {
+    console.log("\nMetadata:");
+    for (const [k, v] of Object.entries(file.metadata)) {
+      console.log(`  ${k}: ${v}`);
+    }
+  }
+}
+async function updateFile(bucket, key, options) {
+  if (!options.metadata || options.metadata.length === 0) {
+    console.error("Error: At least one -m key=value pair is required.");
+    process.exit(1);
+  }
+  const metadata = {};
+  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);
+    }
+    metadata[pair.slice(0, idx)] = pair.slice(idx + 1);
+  }
+  const stow = createStow();
+  const file = await stow.updateFileMetadata(key, metadata, { bucket });
+  if (options.json) {
+    outputJson(file);
+    return;
+  }
+  console.log(`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}/api/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 (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.files.length === 0) {
+    console.log(`No files missing ${type} in bucket '${bucket}'.`);
+    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-YMZTZUFX.js

@@ -0,0 +1,52 @@
+import {
+  adminRequest
+} from "./chunk-WAQSCS57.js";
+import {
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import "./chunk-OZ7QQTIZ.js";
+
+// src/commands/admin/health.ts
+async function health(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/api/health"
+  });
+  if (options.json) {
+    outputJson(result);
+    return;
+  }
+  const statusIcon = result.status === "ok" ? "\u2713" : "\u2717";
+  console.log(`${statusIcon} ${result.status} (${result.version})`);
+  console.log(`  ${result.timestamp}`);
+  console.log("\nChecks:");
+  for (const [name, status] of Object.entries(result.checks)) {
+    const icon = status === "ok" ? "\u2713" : "\u2717";
+    console.log(`  ${icon} ${name}`);
+  }
+  if (result.queues) {
+    console.log("\nQueues:");
+    const rows = [];
+    for (const [name, counts] of Object.entries(result.queues)) {
+      if (counts === "unavailable") {
+        rows.push([name, "\u2014", "\u2014", "\u2014", "\u2014"]);
+      } else {
+        const c = counts;
+        rows.push([
+          name,
+          String(c.waiting ?? 0),
+          String(c.active ?? 0),
+          String(c.completed ?? 0),
+          String(c.failed ?? 0)
+        ]);
+      }
+    }
+    console.log(
+      formatTable(["Queue", "Waiting", "Active", "Completed", "Failed"], rows)
+    );
+  }
+}
+export {
+  health
+};

package/dist/jobs-6JY4SVV5.js

@@ -0,0 +1,92 @@
+import {
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-OZ7QQTIZ.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 = `/api/buckets/${bucketId}/jobs${qs ? `?${qs}` : ""}`;
+  const result = await bucketRequest({
+    method: "GET",
+    path
+  });
+  if (options.json) {
+    outputJson(result.jobs);
+    return;
+  }
+  if (result.jobs.length === 0) {
+    console.log("No jobs found.");
+    return;
+  }
+  const rows = result.jobs.map((job) => [
+    job.jobId,
+    job.queueName,
+    job.status,
+    job.data.fileId.slice(0, 8) + "\u2026",
+    formatTimestamp(job.timestamp),
+    job.failedReason ? job.failedReason.slice(0, 40) : ""
+  ]);
+  console.log(
+    formatTable(["ID", "Queue", "Status", "File", "Created", "Error"], rows)
+  );
+}
+async function retryJob(jobId, options) {
+  const result = await bucketRequest({
+    method: "POST",
+    path: `/api/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: `/api/buckets/${options.bucket}/jobs/${jobId}?queue=${encodeURIComponent(options.queue)}`
+  });
+  if (result.deleted) {
+    console.log(`Job ${jobId} removed.`);
+  }
+}
+export {
+  deleteJob,
+  listJobs,
+  retryJob
+};

package/dist/jobs-OKKGKSIH.js

@@ -0,0 +1,83 @@
+import {
+  adminRequest
+} from "./chunk-WAQSCS57.js";
+import {
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import "./chunk-OZ7QQTIZ.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: `/api/admin/jobs${qs ? `?${qs}` : ""}`
+  });
+  if (options.json) {
+    outputJson(result.jobs);
+    return;
+  }
+  if (result.jobs.length === 0) {
+    console.log("No jobs found.");
+    return;
+  }
+  const rows = result.jobs.map((job) => [
+    job.jobId,
+    job.queueName,
+    job.status,
+    job.data.fileId.slice(0, 8) + "\u2026",
+    job.data.orgId.slice(0, 8) + "\u2026",
+    formatTimestamp(job.timestamp),
+    job.failedReason ? job.failedReason.slice(0, 40) : ""
+  ]);
+  console.log(
+    formatTable(
+      ["ID", "Queue", "Status", "File", "Org", "Created", "Error"],
+      rows
+    )
+  );
+}
+async function retryAdminJob(jobId, options) {
+  const result = await adminRequest({
+    method: "POST",
+    path: `/api/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: `/api/admin/jobs/${jobId}?queue=${encodeURIComponent(options.queue)}`
+  });
+  if (result.deleted) {
+    console.log(`Job ${jobId} removed.`);
+  }
+}
+export {
+  deleteAdminJob,
+  listAdminJobs,
+  retryAdminJob
+};

package/dist/maintenance-EZUHQK5Q.js

@@ -0,0 +1,86 @@
+import {
+  adminRequest
+} from "./chunk-WAQSCS57.js";
+import {
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import "./chunk-OZ7QQTIZ.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: `/api/admin/cleanup-drops${qs ? `?${qs}` : ""}`
+  });
+  if (options.json) {
+    outputJson(result);
+    return;
+  }
+  console.log(
+    options.dryRun ? `[dry run] Would clean up ${result.count ?? 0} drops` : `Cleaned up ${result.deleted ?? 0} drops`
+  );
+}
+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: `/api/admin/purge-events${qs ? `?${qs}` : ""}`
+  });
+  if (options.json) {
+    outputJson(result);
+    return;
+  }
+  console.log(
+    options.dryRun ? `[dry run] Would purge ${result.count ?? 0} events` : `Purged ${result.deleted ?? 0} events`
+  );
+}
+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: `/api/admin/reconcile-files?${params}`
+  });
+  if (options.json) {
+    outputJson(result);
+    return;
+  }
+  if (options.dryRun) {
+    console.log(
+      `[dry run] ${result.mismatched ?? 0} files need reconciliation`
+    );
+  } else {
+    console.log(`Reconciled ${result.reconciled ?? 0} files`);
+  }
+}
+async function retrySyncFailures(options) {
+  const result = await adminRequest({
+    method: "POST",
+    path: "/api/admin/retry-sync-failures"
+  });
+  if (options.json) {
+    outputJson(result);
+    return;
+  }
+  console.log(`Retried ${result.retried ?? 0} sync failures`);
+}
+export {
+  cleanupDrops,
+  purgeEvents,
+  reconcileFiles,
+  retrySyncFailures
+};

package/dist/profiles-GWLBEEIT.js

@@ -0,0 +1,50 @@
+import {
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import {
+  createStow
+} from "./chunk-JYOMHKFS.js";
+import "./chunk-OZ7QQTIZ.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 } : {}
+  });
+  if (options.json) {
+    outputJson(profile);
+    return;
+  }
+  console.log(`Created profile: ${profile.name} (${profile.id})`);
+}
+async function getProfile(id, options) {
+  const stow = createStow();
+  const profile = await stow.profiles.get(id);
+  if (options.json) {
+    outputJson(profile);
+    return;
+  }
+  console.log(`Profile: ${profile.name} (${profile.id})`);
+  if (profile.clusters && profile.clusters.length > 0) {
+    console.log("\nClusters:");
+    const rows = profile.clusters.map((c) => [
+      String(c.index),
+      c.name ?? "(unnamed)",
+      String(c.signalCount)
+    ]);
+    console.log(formatTable(["Index", "Name", "Signals"], rows));
+  }
+}
+async function deleteProfile(id) {
+  const stow = createStow();
+  await stow.profiles.delete(id);
+  console.log(`Deleted profile: ${id}`);
+}
+export {
+  createProfile,
+  deleteProfile,
+  getProfile
+};

package/dist/queues-EQX7EJZF.js

@@ -0,0 +1,51 @@
+import {
+  adminRequest
+} from "./chunk-WAQSCS57.js";
+import {
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import "./chunk-OZ7QQTIZ.js";
+
+// src/commands/admin/queues.ts
+async function listQueues(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/api/admin/queues"
+  });
+  if (options.json) {
+    outputJson(result.queues);
+    return;
+  }
+  const entries = Object.entries(result.queues);
+  if (entries.length === 0) {
+    console.log("No queues found.");
+    return;
+  }
+  const rows = entries.map(([name, counts]) => [
+    name,
+    String(counts.waiting),
+    String(counts.active),
+    String(counts.completed),
+    String(counts.failed)
+  ]);
+  console.log(
+    formatTable(["Queue", "Waiting", "Active", "Completed", "Failed"], rows)
+  );
+}
+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: `/api/admin/queues/${encodeURIComponent(queueName)}/clean`,
+    body: { status, grace }
+  });
+  console.log(
+    `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
+  );
+}
+export {
+  cleanQueue,
+  listQueues
+};

package/dist/search-2PXM6XQ6.js

@@ -0,0 +1,108 @@
+import {
+  formatBytes,
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import {
+  createStow
+} from "./chunk-JYOMHKFS.js";
+import "./chunk-OZ7QQTIZ.js";
+
+// src/commands/search.ts
+async function textSearch(query, options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.text({
+    query,
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log("No results found.");
+    return;
+  }
+  const rows = data.results.map((r) => [
+    r.key,
+    formatBytes(r.size),
+    r.similarity.toFixed(3)
+  ]);
+  console.log(formatTable(["Key", "Size", "Similarity"], rows));
+}
+async function similarSearch(options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.similar({
+    fileKey: options.file,
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log("No similar files found.");
+    return;
+  }
+  const rows = data.results.map((r) => [
+    r.key,
+    formatBytes(r.size),
+    r.similarity.toFixed(3)
+  ]);
+  console.log(formatTable(["Key", "Size", "Similarity"], rows));
+}
+async function colorSearch(options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.color({
+    hex: options.hex,
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log("No results found.");
+    return;
+  }
+  const rows = data.results.map((r) => [
+    r.key,
+    r.contentType,
+    r.colorDistance.toFixed(3)
+  ]);
+  console.log(formatTable(["Key", "Type", "Distance"], rows));
+}
+async function diverseSearch(options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.diverse({
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.results.length === 0) {
+    console.log("No results found.");
+    return;
+  }
+  const rows = data.results.map((r) => [
+    r.key,
+    formatBytes(r.size),
+    r.similarity.toFixed(3)
+  ]);
+  console.log(formatTable(["Key", "Size", "Similarity"], rows));
+}
+export {
+  colorSearch,
+  diverseSearch,
+  similarSearch,
+  textSearch
+};